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Preface 


About  This  Manual 


This  manual  describes  the  X  library,  the  C  Language  programming  interface  to  Version  1 1  of 
the  X  Window  System.  The  X  library,  known  as  Xlib,  is  the  lowest  level  of  programming 
interface  to  X.  This  library  enables  a  programmer  to  write  applications  with  an  advanced 
user  interface  based  on  windows  on  the  screen,  with  complete  network  transparency,  that  will 
run  without  changes  on  many  types  of  workstations  and  personal  computers. 

Xlib  is  powerful  enough  to  write  effective  applications  without  additional  programming  tools 
and  is  necessary  for  certain  tasks  even  in  applications  written  with  higher-level  “toolkits.” 

There  are  a  number  of  these  toolkits  for  X  programming,  the  most  notable  being  the 
DEC/MIT  toolkit  Xt,  the  Andrew  toolkit  developed  by  IBM  and  Camegie-Mellon  University, 
and  the  Interviews  toolkit  from  Stanford.  These  toolkits  are  still  evolving,  and  only  Xt  is 
currently  part  of  the  X  standard.  Toolkits  simplify  the  process  of  application  writing  con¬ 
siderably,  providing  a  number  of  widgets  that  implement  menus,  command  buttons,  and  other 
common  features  of  the  user  interface. 

This  manual  does  not  describe  Xt  or  any  other  toolkit.  That  is  done  in  Volumes  Four,  Five, 
and  Six  of  our  X  Window  System  series.  Nonetheless,  much  of  the  material  described  in  this 
book  is  helpful  for  understanding  and  using  the  toolkits,  since  the  toolkits  themselves  are 
written  using  Xlib  and  allow  Xlib  code  to  be  intermingled  with  toolkit  code. 


Summary  of  Contents 

This  manual  is  divided  into  two  volumes.  This  is  the  second  volume,  the  Xlib  Reference 
Manual.  It  includes  reference  pages  for  each  of  the  Xlib  functions  (organized  alphabeti¬ 
cally),  a  permuted  index,  and  numerous  appendices  and  quick  reference  aids. 

The  first  volume,  the  Xlib  Programming  Manual ,  provides  a  conceptual  introduction  to  Xlib, 
including  tutorial  material  and  numerous  programming  examples.  Arranged  by  task  or  topic, 
each  chapter  brings  together  a  group  of  Xlib  functions,  describes  the  conceptual  foundation 
they  are  based  on,  and  illustrates  how  they  are  most  often  used  in  writing  applications  (or,  in 
the  case  of  the  last  chapter,  in  writing  window  managers).  Volume  One  is  structured  so  as  to 
be  useful  as  a  tutorial  and  also  as  a  task-oriented  reference. 
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Volume  One  and  Volume  Two  are  designed  to  be  used  together.  To  get  the  most  out  of  the 
examples  in  Volume  One,  you  will  need  the  exact  calling  sequences  of  each  function  from 
Volume  Two.  To  understand  fully  how  to  use  each  of  the  functions  described  in  Vol¬ 
ume  Two,  all  but  the  most  experienced  X  “hacker”  will  need  the  explanation  and  examples  in 
Volume  One. 

Both  volumes  include  material  from  the  original  Xlib  and  XI 1  Protocol  documentation  pro¬ 
vided  by  MIT,  as  well  as  from  other  documents  provided  on  the  MIT  release  tape.  We  have 
done  our  best  to  incorporate  all  of  the  useful  information  from  the  MIT  documentation,  to 
correct  references  we  found  to  be  in  error,  to  reorganize  and  present  it  in  a  more  useful  form, 
and  to  supplement  it  with  conceptual  material,  tutorials,  reference  aids,  and  examples.  In 
other  words,  this  manual  is  not  only  a  replacement  but  is  a  superset  of  the  MIT  documenta¬ 
tion. 

Those  of  you  familiar  with  the  MIT  documentation  will  recognize  that  each  reference  page  in 
Volume  Two  includes  the  detailed  description  of  the  routine  found  in  Gettys,  Newman,  and 
Scheifler’s  Xlib-C  Language  X  Interface ,  plus,  in  many  cases,  additional  text  that  clarifies 
ambiguities  and  describes  the  context  in  which  the  routine  would  be  used.  We  have  also 
added  cross  references  to  related  reference  pages  and  to  where  additional  information  can  be 
found  in  Volume  One. 


How  to  Use  This  Manual 


Volume  Two  is  designed  to  make  it  as  easy  and  fast  as  possible  to  look  up  virtually  any  fact 
about  Xlib.  It  includes  a  permuted  index,  reference  pages  for  each  library  function,  appen¬ 
dices  that  cover  macros,  structures,  function  groups,  events,  fonts,  colors,  cursors,  keysyms, 
and  errors,  and  at-a-glance  tables  for  the  graphics  context  and  window  attributes. 

The  permuted  index  is  the  standard  UNIX  way  of  finding  a  particular  function  name  given  a 
keyword.  By  looking  up  a  word  in  the  second  column  that  you  think  describes  the  function 
you  are  looking  for,  you  can  find  the  group  of  functions  that  have  that  word  in  their  descrip¬ 
tion  lines.  The  description  line  also  appears  at  the  top  of  each  reference  page.  Once  you 
have  found  the  routine  you  are  looking  for,  you  can  look  for  its  reference  page. 

The  reference  pages  themselves  provide  all  the  details  necessary  for  calling  each  routine, 
including  its  arguments,  returned  values,  definitions  of  the  structure  types  of  arguments  and 
returned  values,  and  the  errors  it  may  generate.  Many  of  the  pages  also  give  hints  about  how 
the  routine  is  used  in  the  context  of  other  routines.  This  is  the  part  of  this  volume  you  will 
use  the  most. 

Appendix  A,  Function  Group  Summary ,  groups  the  routines  according  to  function,  and  pro¬ 
vides  brief  descriptions.  You’ll  find  it  useful  to  have  in  one  place  a  description  of  related 
routines,  so  their  differences  can  be  noted  and  the  appropriate  one  chosen. 

Appendix  B,  Error  Messages  and  Protocol  Requests ,  describes  the  errors  that  Xlib  routines 
can  generate.  When  an  error  is  handled  by  the  default  error  handler,  one  of  these  messages  is 
printed.  Also  printed  is  the  X  Protocol  request  that  caused  the  error.  Since  Protocol  requests 
do  not  map  directly  to  Xlib  routines,  this  appendix  provides  a  table  with  which  you  can  find 
out  which  Xlib  routine  in  your  code  caused  the  error. 
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Appendix  C,  Macros ,  describes  the  macros  that  access  members  of  the  Display  structure, 
classify  keysyms,  and  convert  resource  manager  types. 

Appendix  D,  ColorCaEE ,  presents  the  standard  color  database.  The  color  names  in  this  data¬ 
base  should  be  available  on  all  servers,  though  the  corresponding  RGB  values  may  have  been 
modified  to  account  for  screen  variations. 

Appendix  E,  Event  Reference ,  describes  each  event  type  and  structure,  in  a  reference  page 
format.  This  is  an  invaluable  reference  for  event  programming. 

Appendix  F,  Structure  Reference ,  describes  all  structures  used  by  Xlib  except  the  event  struc¬ 
tures  described  in  Appendix  E,  including  which  routines  use  each  structure. 

Appendix  G,  Symbol  Reference ,  lists  in  alphabetical  order  and  describes  all  of  the  symbols 
defined  in  Xlib  include  files. 

Appendix  H,  Keysym  Reference ,  lists  and  describes  each  character  in  the  standard  keysym 
families,  used  for  translating  keyboard  events.  The  characters  for  English  and  foreign  lan¬ 
guage  keysyms  are  shown  where  possible. 

Appendix  I,  The  Cursor  Font ,  describes  the  standard  cursor  font,  including  a  illustration  of 
the  font  shapes. 

Appendix  J,  The  Xmu  Library ,  provides  reference  pages  for  each  function  in  the  miscella¬ 
neous  utilities  library.  This  library  is  provided  with  the  standard  X  distribution  and  is  very 
useful  when  programming  with  Xlib. 

Finally,  Volume  Two  concludes  with  at-a-glance  charts  that  help  in  setting  the  graphics  con¬ 
text  (GC)  and  the  window  attributes. 


Example  Programs 

The  example  programs  in  this  book  are  on  the  XI 1  Release  4  distribution  in  the  contributed 
section.  There  are  many  ways  of  getting  this  distribution;  most  are  described  in  Appendix  H. 

The  example  programs  are  also  available  free  from  UUNET  (that  is,  free  except  for  UUNET’s 
usual  connect-time  charges).  If  you  have  access  to  UUNET,  you  can  retrieve  the  source  code 
using  uucp  or  ftp.  For  uucp ,  find  a  machine  with  direct  access  to  UUNET  and  type  the  follow¬ 
ing  command: 

uucp  uunetA!  ~uucp/nutshell/Xlib/xlibprgs  .  tar  .  Z  yourhosM" /yourname/ 

The  backslashes  can  be  omitted  if  you  use  the  Bourne  shell  ( sh )  instead  of  csh.  The  file 
should  appear  some  time  later  (up  to  a  day  or  more)  in  the  directory  /usr/spool/uucp- 
publicl  yourname. 

To  use  ftp,  ftp  to  uunet.uu.net  and  use  anonymous  as  your  user  name  and  guest  as  your  pass¬ 
word.  Then  type  the  following: 

cd  /nutshell/Xlib 

binary  ( you  must  specify  binary  transfer  for  compressed  files) 

get  xlibprgs . tar . Z 

bye 
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The  file  is  a  compressed  tar  archive.  To  restore  the  files  once  you  have  retrieved  the  archive, 
type: 

uncompress  xlibprgs.tar 
tar  xvf  xlibprgs.tar 

The  example  programs  are  also  available  free  by  ftp  from  expo.lcs.mit.edu.  The  directory 
containing  the  examples  is  contrib/ examples! OReilly/Xlib . 

The  examples  will  be  installed  in  subdirectories  under  the  current  directory,  one  for  each 
chapter  in  the  book.  Imakefiles  are  included.  (Imakefiles  are  used  with  imake ,  a  program 
supplied  with  the  XI 1  distribution  that  generates  proper  Makefiles  on  a  wide  variety  of  sys¬ 
tems.) 

Assumptions 

Readers  should  be  proficient  in  the  C  programming  language,  although  examples  are  pro¬ 
vided  for  infrequently  used  features  of  the  language  that  are  necessary  or  useful  when  pro¬ 
gramming  with  X.  In  addition,  general  familiarity  with  the  principles  of  raster  graphics  will 
be  helpful. 

Font  Conventions  Used  in  This  Manual 

Italic  is  used  for: 

•  UNIX  pathnames,  filenames,  program  names,  user  command  names,  and  options  for  user 
commands. 

•  New  terms  where  they  are  defined. 

Typewriter  Font  is  used  for: 

•  Anything  that  would  be  typed  verbatim  into  code,  such  as  examples  of  source  code  and 
text  on  the  screen. 

•  The  contents  of  include  files,  such  as  structure  types,  structure  members,  symbols 
(defined  constants  and  bit  flags),  and  macros. 

•  Xlib  functions. 

•  Names  of  subroutines  of  the  example  programs. 

Italic  Typewriter  Font  is  used  for: 

•  Arguments  to  Xlib  functions,  since  they  could  be  typed  in  code  as  shown  but  are  arbi¬ 
trary. 

Helvetica  Italics  are  used  for: 

•  Titles  of  examples,  figures,  and  tables. 
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Boldface  is  used  for: 

•  Chapter  and  section  headings. 


Related  Documents 


The  C  Programming  Language  by  B.  W.  Kemighan  and  D.  M.  Ritchie 

The  following  documents  are  included  on  the  XI 1  source  tape: 

Xt  Toolkit  Intrinsics  by  Joel  McCormack,  Paul  Asente,  and  Ralph  Swick 
Xt  Toolkit  Widgets  by  Ralph  Swick  and  Terry  Weissman 

Xlib-C  Language  X  Interface  by  Jim  Gettys,  Ron  Newman,  and  Robert  Scheifler 
X  Window  System  Protocol,  Version  77  by  Robert  Scheifler 

The  following  books  on  the  X  Window  System  are  available  from  O’Reilly  and  Associates, 
Inc.: 


Volume  Zero  —  X  Protocol  Reference  Manual 

Volume  Three  —  X  Window  System  User’s  Guide 

Volume  Four  —  X  Toolkit  Intrinsics  Programming  Manual 

Volume  Five  —  X  Toolkit  Intrinsics  Reference  Manual 

Volume  Six  — X  Toolkit  Widgets  Reference  Manual  (available  summer  1990) 

Volume  Seven  — XView  Programmer’ s  Guide 
Quick  Reference  —  The  X  Window  System  in  a  Nutshell 

Requests  for  Comments 

Please  write  to  tell  us  about  any  flaws  you  find  in  this  manual  or  how  you  think  it  could  be 

improved,  to  help  us  provide  you  with  the  best  documentation  possible. 

Our  U.S.  mail  address,  e-mail  address,  and  telephone  number  are  as  follows: 

O’Reilly  and  Associates,  Inc. 

632  Petaluma  Avenue 

Sebastopol,  CA  95472 

(800)  338-6887 

UUCP:  uunet!ora!adrian  ARPA:  adrian@ora.UU.NET 
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Bulk  Sales  Information 


This  manual  is  being  resold  as  the  official  X  Window  System  documentation  by  many  work¬ 
station  manufacturers.  For  information  on  volume  discounts  for  bulk  purchase,  call  Linda 
Walsh  at  O’Reilly  and  Associates,  Inc.,  at  617-354-5800,  or  send  e-mail  to  linda@ ora.com. 

For  companies  requiring  extensive  customization  of  the  book,  source  licensing  terms  are  also 
available. 
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How  to  Use  the  Permuted  Index 


The  permuted  index  takes  the  brief  descriptive  string  from  the  title  of  each  command  page 
and  rotates  (permutes)  the  string  so  that  each  keyword  will  at  one  point  start  the  second ,  or 
center,  column  of  the  line.  The  beginning  and  end  of  the  original  string  are  indicated  by  a 
slash  when  they  are  in  other  than  their  original  position;  if  the  string  is  too  long,  it  is  trun¬ 
cated. 

To  find  the  command  you  want,  simply  scan  down  the  middle  of  the  page,  looking  for  a  key¬ 
word  of  interest  on  the  right  side  of  the  blank  gutter.  Once  you  find  the  keyword  you  want, 
you  can  read  (with  contortions)  the  brief  description  of  the  command  that  makes  up  the  entry. 
If  things  still  look  promising,  you  can  look  all  the  way  over  to  the  right  for  the  name  of  the 
relevant  command  page. 

The  Permuted  Index 


for  string  and  font  metrics  of  a 
/get  string  and  font  metrics  of  a 
/get  the  width  in  pixels  of  a 
XDrawImageStringl6:  draw 
XDrawTextl6:  draw 
/get  the  width  in  pixels  of  an 
X DrawImageString:  draw 
XDrawText:  draw 
only  XDrawString:  draw  an 
/disable  or  enable 
XAddHost:  add  a  host  to  the 
add  multiple  hosts  to  the 
/remove  a  host  from  the 
/remove  multiple  hosts  from  the 
deny/  XEnableAccessControl:  use 
XDisableAccessControl:  allow 
/obtain  a  list  of  hosts  having 
XActivateScreenSaver: 
release  the  keyboard  from  an 
release  the  pointer  from  an 
/change  the  parameters  of  an 
pixel  value  in  an/  XAddPixel: 

list  XAddHost: 


16-bit  character  string  /server  ., 
16-bit  character  string,  locally  .. 
16-bit  character  string,  locally  .. 

16-bit  image  text  characters  . 

16-bit  polytext  strings  . 

8-bit  character  string,  locally  .... 

8-bit  image  text  characters . 

8-bit  polytext  strings  . 

8-bit  text  string,  foreground . 

access  control  . 

access  control  list . 

access  control  list  XAddHosts: 
access  control  list  ...................... 

access  control  list . 

access  control  list  to  allow  or  ... 

access  from  any  host . 

access  to  this  display . 

activate  screen  blanking  . 

active  grab  XUngrabKeyboard: 
active  grab  XUngrabPointer:  ... 

active  pointer  grab . . 

add  a  constant  value  to  every  ... 
add  a  host  to  the  access  control 


XQueryTextExtents  1 6 

XTextExtentsl6 

XTextWidthl6 

XDra  wlmageString  1 6 

XDrawTextl6 

XTextWidth 

XDrawImageString 

XDrawText 

XDrawString 

XSetAccessControl 

XAddHost 

XAddHosts 

XRemoveHost 

XRemoveHosts 

XEnableAccessControl 

XDisableAccessControl 

XListHosts 

XActivateScreenSaver 

XUngrabKeyboard 

XUngrabPointer 

XChangeActivePointerGrab 

XAddPixel 

XAddHost 
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XlnsertModifiermapEnlry:  add  a  new  entry  to  an/  - ......... — ..  XInsertModifiermapEntry 

XUnionRectWithRegion:  add  a  rectangle  to  a  region . XUnionRectWithRegion 

a/  XrmQPutStringResource:  add  a  resource  specification  to  .......... - XrmQPutStringResource 

a  resource/  XrmPutLineResource:  add  a  resource  specification  to  .......... - XrmPutLineResource 

with/  XrmPutStringResource:  add  a  resource  specification  .....................  XrmPutStringResource 

save-set  XAddToSaveSet:  add  a  window  to  the  client’s . XAddToSaveSet 

control  list  XAddHosts:  add  multiple  hosts  to  the  access . XAddHosts 

the  client’s/  XChangeSaveSet:  add  or  remove  a  sub  window  from  . XChangeSaveSet 

XrmUniqueQuark:  allocate  a  new  quark  . XrmUniqueQuark 

from  color/  XAllocNamedColor:  allocate  a  read-only  colorcell  . — ...... — ..  XAllocNamedColor 

cell  with  closest/  XAllocColor:  allocate  a  read-only  colormap . XAllocColor 

XAllocClassHint:  allocate  an  XClassHint  structure . XAllocClassHint 

XAllocIconSize:  allocate  an  XlconSize  structure . XAllocIconSize 

XAllocSizeHints:  allocate  an  XSizeHints  structure . XAllocSizeHints 

XAllocStandardColormap:  allocate  an  XStandardColormap/ . XAllocStandardColormap 

X Alloc WMHints:  allocate  an  XWM Hints  structure . X Alloc WMHints 

structure  XCreatelmage:  allocate  memory  for  an  Xlmage . XCreatelmage 

freed  Xpermalloc:  allocate  memory  never  to  be  . Xpermalloc 

XAllocColorPlanes:  allocate  read/write/ . XAllocColorPlanes 

colorcells  XAllocColorCells:  allocate  read/write  (nonshared)  ................  XAUocColorCells 

XFree:  free  specified  memory  allocated  by  an  Xlib  function  . XFree 

XFreeFontPath:  free  the  memory  allocated  by  XGetFontPath  . XFreeFontPath 

XFreeFontNames:  free  the  memory  allocated  by  XListFonts . XFreeFontNames 

XFreeFontlnfo:  free  the  memory  allocated  by  XListFontsWithlnfo . XFreeFontlnfo 

XFreeExtensionList:  free  memory  allocated  for  a  list  of/ . XFreeExtensionList 

table,  /free  the  memory  allocated  for  an  association  . XDestroyAssocTable 

XDisableAccessControl:  allow  access  from  any  host . XDisableAccessControl 

/use  access  control  list  to  allow  or  deny  connection/ . XEnableAccessControl 

colormap;  install  default  if  not  already  installed  /uninstall  a  . XUninstallColormap 

XLoadFont:  load  a  font  if  not  already  loaded;  get  font  ID . XLoadFont 

contents  of  one  database  into  another  /merge  the . XrmMergeDatabases 

subtract  one  region  from  another  XSubtractRegion:  . XSubtractRegion 

system  from  one  window  to  another  /change  the  coordinate . XTranslateCoordinates 

/move  the  pointer  to  another  point  on  the  screen . XWarpPointer 

/insert  a  window  between  another  window  and  its  parent  . XReparcntWindow 

into  a  drawable  with  depth,  applying  pixel  values  /drawable . XCopyPlane 

/convert  a  keysym  to  the  appropriate  keycode . XKeysymToKeycode 

XFillArc:  fill  an  arc _ XFillArc 

XDrawArc:  draw  an  arc  fitting  inside  a  rectangle  . XDrawArc 

XSetArcMode:  set  the  arc  mode  in  a  graphics  context . XSetArcMode 

XDrawArcs:  draw  multiple  arcs  . XDrawArcs 

XFillArcs:  fill  multiple  arcs . XFillArcs 

fill  a  rectangular  area  XFillRectangle: . XFillRectangle 

XGcarArea:  clear  a  rectangular  area  in  a  window  . XClearArea 

XCopyArea:  copy  an  area  of  a  drawable . XCopyArea 

fill  multiple  rectangular  areas  XFillRcctanglcs:  . XFillRectangles 

database  from  command  line  arguments  /load  a  resource  . XrmParseCommand 

XA_WM_COMMAND  atom  (command  line  arguments)  XSetCommand:  set  the  . . XSetCommand 

properties  in  the  properties  array  /rotate . XRotateWindowProperties 

/obtain  RGB  values  for  an  array  of  colorcells . XQueryColors 

/look  up  RGB  values  from  ASCII  color  name  or  translate/ . XParseColor 

/map  a  key  event  to  ASCII  string,  keysym,  and/  ......................  XLookupString 

XDefineCursor:  assign  a  cursor  to  a  window  . XDefineCursor 

the  window  manager  XStoreName:  assign  a  name  to  a  window  for  .................  XStoreName 

/deallocate  storage  associated  with  a  region . XDestroyRegion 

/change  a  property  associated  with  a  window  .......... - - - XChangeProperty 

XDestroylmage:  deallocate  memory  associated  with  an  image . XDestroylmage 

/the  GContext  (resource  ID)  associated  with  the  specified/  ...................  XGContextFromGC 
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/the  XStandardColormap  structure 
string/  /free  the  in-memory  data 
/delete  an  entry  from  an 
/free  the  memory  allocated  for  an 
obtain  data  from  an 
create  an  entry  in  an 
XCreateAssocTable:  create  a  new 
name  for  a  property  given  its 
get  a  font  property  given  its 
/set  the  XA_WM_COMMAND 
string  XIn  tern  Atom:  return  an 
XGetWindowProperty:  obtain  the 
/a  window  border  pixel  value 
/change  a  window  border  tile 
/set  the  colormap 
/set  the  background  pixel  value 
/change  the  background  tile 
/set  window 
create  a  window  and  set 
/obtain  the  current 
Aum  off  the  keyboard 
turn  on  the  keyboard 
XPutBackEvent:  push  an  event 
XSetState:  set  the  foreground, 
XSelWindowBackground:  set  the 
XSetBackground:  set  the 
window  /change  the 
XAllowEvents:  control  the 
XBell:  ring  the 
or/  XQueryBestSize:  obtain  the 
XReparentWindow:  insert  a  window 
/calculate  the  difference 
XDrawLine:  draw  a  line 
XDraw:  draw  a  polyline  or  curve 
/convert  a  key  string  to  a 
of  the/  XQueryKeymap:  obtain  a 
/create  a  pixmap  with  depth  from 
/create  a  bitmap  from  XI 1 
XReadBitmapFile:  read  a 
XCreateBitmapFromData:  create  a 
XWriteBitmapFile:  write  a 
create  a  cursor  from  two 
graphics/  XSetFunction:  set  the 
activate  screen 
value  attribute  and  repaint  the 
tile  attribute  and  repaint  the 
repaint  the/  /change  a  window 
repaint  the/  /change  a  window 
/change  the 
/the  window  position,  size, 
/remove  the  next  event  matching 
stacking  order  /circulate  the 
/circulate  the  top  child  to  the 
return  data  from  a  cut 
from  pointer  motion  history 
store  data  in  a  cut 
return  data  from  cut 
XStoreBytes:  store  dau  in  cut 


associated  with  the  specified/ . 

associated  with  the  specified  ............. 

association  Uble.  .......... . . . 

association  uble . . 

association  uble  XLookUpAssoc:  ... 

association  uble  XMakeAssoc: . 

association  uble  (X10)  ...................... 

atom  XGetAtomName:  get  a  string  .. 
atom  XGetFontProperty: ................... 

atom  (command  line  arguments)  ...... 

atom  for  a  given  property  name _ .... 

atom  type  and  property  format/ _ 

attribute  and  repaint  the  border . 

attribute  and  repaint  the  border  ......... 

attribute  for  a  window  . . 

attribute  of  a  window . 

attribute  of  a  window . 

attributes  . . 

attributes  XCreateWindow:  . 

attributes  of  window  . 

auto-repeat  keys  . 

auto-repeat  keys  XAutoRepeatOn:  .. 

back  on  the  input  queue . 

background,  logical  function  y . 

background  pixel  value  attribute/  . 

background  pixel  value  in  a/ . 

background  tile  attribute  of  a  . 

behavior  of  keyboard  and  pointer/  .... 

bell  (Control  G) . 

"best"  supported  cursor,  tile,  . 

between  another  window  and  its/ . 

between  the  union  and/ . 

between  two  points  . 

between  vertex  list  (from  X10) . 

binding  list  and  a  quark  list  . 

bit  vector  for  the  current  state . 

bitmap  data . 

bitmap  format  data  . 

bitmap  from  disk  . . . 

bitmap  from  XI 1  bitmap  format/ . 

bitmap  to  a  file  . . 

bitmaps  XCrealePixmapCursor: . 

bitwise  logical  operation  in  a . 

blanking  XActivateScreenSaver:  . 

border  /a  window  border  pixel  . . 

border  /change  a  window  border . 

border  pixel  value  attribute  and  . . 

border  tile  attribute  and . 

border  width  of  a  window  . . 

border  width,  or  stacking  order - - 

both  passed  window  and  passed/ . 

bottom  child  to  the  top  of  the  ............ 

bottom  of  the  stacking  order . 

buffer  XFeichBuffen ...... - 

buffer  /get  events . . . 

buffer  XStoreBuffer: - ... 

buffer  0  XFetchBytes: . 

buffer  0 ................................................ 


- XGetRGBColormaps 

.......  XFreeStringList 

- XDeleteAssoc 

.......  XDestroyAssocTable 

.......  XLookUpAssoc 

. XMakeAssoc 

- XCreateAssocTable 

.......  XGetAtomName 

.......  XGetFontProperty 

.......  XSetCommand 

.......  XIntemAlom 

. XGetWindowProperty 

.......  XSetWindowBorder 

.......  XSetWindowBorderPixmap 

.......  XSetWindowColormap 

.......  XSetWindowBackground 

. XSetWindowBackgroundPixmap 

.......  XChangeWindowAttributes 

.......  XCreateWindow 

.......  XGetWindowAttributes 

. XAutoRepeatOff 

.......  XAutoRepeatOn 

.......  XPutBackEvent 

. XSetState 

.......  XSetWindowBackground 

. XSetBackground 

. XSetWindowBackgroundPixmap 

. XAllowEvents 

. . XBell 

. XQueryBestSize 

. XReparentWindow 

.......  XXorRegion 

. XDrawLine 

. XDraw 

.......  XnmStringToBindingQuarkList 

. XQueryKeymap 

. XCreatePixmapFromBitmapData 

. XCreateBitmapFromData 

. XReadBitmapFile 

. XCreateBitmapFromData 

.......  XWriteBitmapFile 

. XCreatePixmapCursor 

. XSetFunction 

.......  XActivateScreenSaver 

.......  XSetWindowBorder 

. XSetWindowBorderPixmap 

.......  XSetWindowBorder 

. XSetWindowBorderPixmap 

. . XSetWindowBorderWidth 

. XConfigureWindow 

. XCheckWindowEvent 

. XCirculateSubwindowsDown 

. XCirculateSubwindowsUp 

_ XFetchBuffer 

. XGetMotionEvcnts 

... —  XStoreBuffer 

. XFetchBytes 

. XStoreBytes 
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XPending:  flush  the  request 
and/  XSync:  flush  the  request 
XFlush:  flush  the  request 
XRotateBuffers:  rotate  the  cut 
XGrabButton:  grab  a  pointer 
XUngrabButlon:  release  a 
/get  the  pointer 
/set  the  pointer 
of  a  given  GC  from  Xlib’s  GC 
the  union  and/  XXorRegion: 
user  geometry  string/  XGeometry: 

/set  a  function 
allocate  a  read-only  colormap 
with  a  window  XChangeProperty: 
value/  XSetWindowBorder: 
XSetWindowBorderPixmap: 

XResizeWindow: 
context  to/  XSetClipRectangles: 

XOffsetRegion: 
XSetWindowBackgroundPixmap: 
window  XSetWindowBorderWidth: 
client  XSetCloseDownMode: 

XRecolorCursor: 
graphics  context  XChangeGC: 
from  one/  XTranslateCoordinates: 
XChangeKeyboardMapping: 
such  as/  XChangeKeyboardControl: 
XChangeActivePointerGrab: 
XChangePointerControl: 
read/write/  XStoreColor:  set  or 
rcad/write/  XStoreColors:  set  or 
a  window  XMoveResizeWindow: 

siblings  XRestackWindows: 
property  XSetStandardColormap: 
size,  border/  XConfigureWindow: 
and  font  metrics  of  a  16-bit 
/and  font  metrics  of  a  16-bit 
the  width  in  pixels  of  an  8 -bit 
the  width  in  pixels  of  a  16-bit 
draw  8-bit  image  text 
draw  16-bit  image  text 
matching  event  XChecklfEvent: 
the  event  queue  XEventsQueued: 
stacking/  /circulate  the  top 
order  /circulate  the  bottom 
XQueryTree:  return  a  list  of 
/circulate  the  stacking  order  of 
the/  XCirculateSubwindowsDown: 
children/  XCirculateSubwindows: 
bottom/  XCirculateSubwindowsUp: 
matches  the  desired  depth  and 
a  resource  value  using  name  and 
/get  a  resource  from  name  and 
window  X Clear  Area: 

XClearWindow: 
keyboard  preferences  such  as  key 
rebind  a  keysym  to  a  string  for 
change  the  close  down  mode  of  a 


buffer  and  return  the  number  of/  ..............  XPending 

buffer  and  wait  for  all  events . XSync 

buffer  (display  all  queued/ . XFlush 

buffers . XRotateBuffers 

button . . . XGrabButton 

button  from  a  passive  grab . XUngrabButton 

button  mapping  . XGetPointerMapping 

button  mapping  . XSetPointerMapping 

cache  /obtain  components . XGetGCValues 

calculate  the  difference  between . XXorRegion 

calculate  window  geometry  given  . XGeometry 

called  after  all  Xlib  functions  . XSctAfterFunction 

cell  with  closest/  XAllocColor: . XAllocColor 

change  a  property  associated . XChangeProperty 

change  a  window  border  pixel . XSetWindowBorder 

change  a  window  border  tile/ . XSetWindowBorderPixmap 

change  a  window’s  size . XResizeWindow 

change  clip_mask  in  a  graphics  ...............  XSetClipRectangles 

change  offset  of  a  region  . XOffsetRegion 

change  the  background  tile/ . XSetWindowBackgroundPixmap 

change  the  border  width  of  a . XSetWindowBorderWidth 

change  the  close  down  mode  of  a . XSetCloseDownMode 

change  the  color  of  a  cursor . XRecolorCursor 

change  the  components  of  a  given . XChangeGC 

change  the  coordinate  system  . XTranslateCoordinates 

change  the  keyboard  mapping  . XChangeKeyboardMapping 

change  the  keyboard  preferences . XChangeKeyboardControl 

change  the  parameters  of  an/ . XChangeActivePointerGrab 

change  the  pointer  preferences . XChangePointerControl 

change  the  RGB  values  of  a . XStoreColor 

change  the  RGB  values  of . XStoreColors 

change  the  size  and  position  of . XMoveResizeWindow 

change  the  stacking  order  of  . XRestackWindows 

change  the  standard  colormap . XSetStandardColormap 

change  the  window  position, . XConfigureWindow 

character  string  /for  string . XQueryTextExtentsl6 

character  string,  locally . XTextExtentsl6 

character  string,  locally  /get . XTextWidth 

character  string,  locally  /get . XTextWidth  16 

characters  XDrawImageString:  . XDrawImageString 

characters  XDrawImageString  16: . XDrawImageString  16 

check  the  event  queue  for  a . XChecklfEvent 

check  the  number  of  events  in . XEventsQueued 

child  to  the  bottom  of  the . XCirculateSubwindowsUp 

child  to  the  top  of  the  stacking  . XCirculateSubwindowsDown 

children,  parent,  and  root . XQueryTree 

children  up  or  down . XCirculateSubwindows 

circulate  the  bottom  child  to . XCirculateSubwindowsDown 

circulate  the  stacking  order  of . XCirculateSubwindows 

circulate  the  top  child  to  the  . XCirculateSubwindowsUp 

class  /visual  information  that . XMatchVisuallnfo 

class  as  quarks  /get . XrmQGetResource 

class  as  strings . XrmGetResource 

clear  a  rectangular  area  in  a . XClearArea 

clear  an  entire  window . XClearWindow 

click  /change  the . XChangeKeyboardControl 

client  XRebind Keysym: . XRebindKeysym 

client  XSetCloseDownMode:  ........... - XSetCloseDownMode 


4 


Xlib  Reference  Manual 


XKiUClient:  destroy  a  client  or  its  remaining/  ..............................  XKillClient 

and/  X Close  Display:  disconnect  a  client  program  from  an  X  server . .  XCloseDisplay 

XOpenDisplay:  connect  a  client  program  to  an  X  server . XOpenDisplay 

/add  a  window  to  the  client’s  save-set  ................... _ _ _ XAddToSaveSet 

or  remove  a  subwindow  from  the  client’s  save-set  /add  . . XChangeSaveSet 

/remove  a  window  from  the  client’s  save-set . XRemoveFromSaveSet 

context  XSetClipOrigin:  set  the  clip  origin  in  a  graphics  . . XSetClipOrigin 

to  a/  XSetClipRectangles:  change  clip_mask  in  a  graphics  context ...............  XSetClipRectangles 

context  to  the/  XSetRegion:  set  clip_mask  of  the  graphics  .........................  XSetRegion 

context  XSetClipMask:  set  clip_mask  pixmap  in  a  graphics . XSetClipMask 

XSetCloseDownMode:  change  the  close  down  mode  of  a  client .....................  XSetCloseDownMode 

/a  read-only  colormap  cell  with  closest  hardware-supported  color . XAllocColor 

/get  database  RGB  values  and  closest  hardware-supported  RGB/  ...........  XLookupColor 

/read/write  colormap  entry  to  the  closest  possible  hardware  color ................  XStoreColor 

/of  read/write  colorcells  to  the  closest  possible  hardware  colors . XStoreColors 

XQueryBestCursor:  get  the  closest  supported  cursor  sizes  ..................  XQueryBestCursor 

obtain  a  description  of  error  code  XGetErrorText: . . XGetErrorText 

with  closest  hardware-supported  color  /a  read-only  colormap  cell . XAllocColor 

to  the  closest  possible  hardware  color  /read/write  colormap  entry . .  XStoreColor 

a  read-only  colorcell  from  color  name  /allocate  .................................  XAllocNamedColor 

RGB  values  from  color  name  /hardware-supported . . XLookupColor 

of  a  read/write  colorcell  by  color  name  /set  RGB  values . XStoreNamedColor 

/look  up  RGB  values  from  ASCII  color  name  or  translate/  . XParseColor 

XRecolorCursor:  change  the  color  of  a  cursor  ........................................  XRecolorCursor 

read/write  (nonshareable)  color  planes  /allocate . XAllocColorPlanes 

values  and  flags  for  a  specified  colorcell  /obtain  the  RGB  . .  XQueryColor 

/set  RGB  values  of  a  read/write  colorcell  by  color  name  - - - ..........  XStoreNamedColor 

/allocate  a  read-only  colorcell  from  color  name  . XAllocNamedColor 

allocate  read/write  (nonshared)  colorcells  XAllocColorCells: . XAllocColorCells 

RGB  values  for  an  array  of  colorcells  XQueryColors:  obtain . XQueryColors 

/the  RGB  values  of  read/write  colorcells  to  the  closest/ . XStoreColors 

XCreateColormap:  create  a  colormap . XCreateColormap 

colormap  and  install  the  default  colormap  /delete  a  . XFreeColormap 

XInstallColormap:  install  a  colormap . XInslallColormap 

XFreeColormap:  delete  a  colormap  and  install  the  default/ . XFreeColormap 

XCopyColormapAndFree:  copy  a  colormap  and  return  a  new/ . XCopyColormapAndFree 

XSetWindowColormap:  set  the  colormap  attribute  for  a  window . XSetWindowColormap 

/allocate  a  read-only  colormap  cell  with  closest/ . XAllocColor 

XFreeColors:  free  colormap  cells  or  planes  . XFreeColors 

/the  RGB  values  of  a  read/write  colormap  entry  to  the  closest/ . XStoreColor 

/copy  a  colormap  and  return  a  new  colormap  ID . XCopyColormapAndFree 

XUninstallColormap:  uninstall  a  colormap;  install  default  if  not/ . XUninstallColormap 

/get  the  standard  colormap  property . XGetStandardColormap 

/change  the  standard  colormap  property  ........................... — ......  XSetStandardColormap 

/get  a  list  of  installed  colormaps  .............. _ ........... - ...........  XListlnstalledColormaps 

to  the  closest  possible  hardware  colors  /of  rcad/write  colorcells  ................  XStoreColors 

/load  a  resource  database  from  command  line  arguments  . . XrmParseCommand 

/set  the  XA_WM_COMMAND  atom  (command  line  arguments) . XSetCommand 

/set  the  graphics_exposures  component  in  a  graphics  context  .............  XSetGraphicsExposures 

/set  the  line  drawing  components  in  a  graphics  context ............  XSctLineAttributes 

Xlib’s  GC/  XGetGCValues:  obtain  components  of  a  given  GC  from  — - - XGetGCValues 

context  XChangeGC:  change  the  components  of  a  given  graphics . «...  XChangeGC 

to  ASCH  string,  keysym,  and  ComposeStatus  /map  a  key  event ............  XLookupString 

regions  XIntersectRegion:  compute  the  intersection  of  two  . — . XIntersectRegion 

XUnionRegion:  compute  the  union  of  two  regions  ... - XUnionRegion 

server  XOpenDisplay:  connect  a  client  program  to  an  X - XOpenDisplay 

XDrawLines:  draw  multiple  connected  lines . XDrawLines 

control  list  to  allow  or  deny  connection  requests  /use  access - - —  XEnableAccessControl 
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/report  the  display  name  (when 
XNoOp:  send  a  NoOp  to  exercise 
value  in  an/  XAddPixel:  add  a 
drawable  into/  XGetlmage:  place 
XrmMergeDatabases:  merge  the 
components  of  a  given  graphics 
XCopyGC:  copy  a  graphics 
context  manager  (not  graphics 
XFreeGC:  free  a  graphics 
with  the  specified  graphics 
and  context  type  (not  graphics 
set  the  arc  mode  in  a  graphics 
pixel  value  in  a  graphics 
clip_mask  pixmap  in  a  graphics 
the  clip  origin  in  a  graphics 
of  line  dashes  in  a  graphics 
set  the  fill  rule  in  a  graphics 
set  the  fill  style  in  a  graphics 
the  current  font  in  a  graphics 
pixel  value  in  a  graphics 
logical  operation  in  a  graphics 
component  in  a  graphics 
drawing  components  in  a  graphics 
set  the  plane  mask  in  a  graphics 
and  plane  mask  in  a  graphics 
set  the  stipple  in  a  graphics 
the  subwindow  mode  in  a  graphics 
set  the  fill  tile  in  a  graphics 
origin  in  a  graphics 
a  new  context  ID  (not  graphics 
and/  XDeleteContext:  delete  a 
XCreateGC:  create  a  new  graphics 
XUniqueContext:  create  a  new 
XFindContext:  get  data  from  the 
/change  clip_mask  in  a  graphics 
/set  clip_mask  of  the  graphics 
/corresponding  to  a  window  and 
disable  or  enable  access 
mapping  of  modifier  keys  (Shift, 
to  be  used  as  modifiers  (Shift, 
XBell:  ring  the  bell 
add  a  host  to  the  access 
add  multiple  hosts  to  the  access 
remove  a  host  from  the  access 
multiple  hosts  from  the  access 
XEnableAccessControl:  use  access 
and  pointer/  XAllowEvents: 
XrmStringToBindingQuaikList: 
list  XrmStringToQuarkList: 

XKeycodeToKeysym: 
a  keysym  XStringToKeysym: 
string  XKeysymToString: 
appropriate/  XKeysymToKeycode: 

XrmQuarkToString : 

XrmStringToQuark: 
window  to  another  /change  the 
colormap/  XCopyColormapAndFree: 

XCopyGC: 


connection  to  a  display  fails)  .... — . XDisplayName 

connection  with  the  server ........................  XNoOp 

constant  value  to  every  pixel ....................  XAddPixel 

contents  of  a  rectangle  from  .... . . —  XGetlmage 

contents  of  one  database  into/  ..................  XrmMergeDatabases 

context  XChangeGC:  change  the - XChangeGC 

context .... — ...............................................  XCopyGC 

context)  /get  data  from  the  ......... — . XFindContext 

context  .................................................  XFreeGC 

context  /ID)  associated  - - - — _ _ XGContextFromGC 

context)  /to  a  window  ..... — ......................  XSaveContext 

context  XSetArcMode:  . XSetArcMode 

context  /set  the  background  .....................  XSetBackground 

context  XSetQipMask:  set  ......................  XSetClipMask 

context  XSetQipOrigin:  set .....................  XSetClipOrigin 

context  /set  a  pattern  .... — ................ — ....  XSetDashes 

context  XSetFillRule: . XSetFillRule 

context  XSetFillStyle:  ..... - - - .......  XSetFillStyle 

context  XSetFont:  set . XSetFont 

context  /set  the  foreground  ......................  XSetForeground 

context  /set  the  bitwise  ....... - ...............  XSetFunction 

context  /the  graphics_exposures  . XSetGraphicsExposures 

context  /set  the  line  ...» . XSetLineAttributes 

context  XSetPlaneMask: ..........................  XSetPlaneMask 

context  /logical  function,  .........................  XSetState 

context  XSetStipple: . XSetStipple 

context  XSetSubwindowMode:  set . XSetSubwindowMode 

context  XSetTile: . XSetTile 

context  /set  the  tile/stipple . XSetTSOrigin 

context)  XUniqueContext:  create . XUniqueContext 

context  entry  for  a  given  window  ............  XDeleteContext 

context  for  a  given  screen  with/ . XCreateGC 

context  ID  (not  graphics/ . XUniqueContext 

context  manager  (not  graphics/  . . XFindContext 

context  to  a  list  of  rectangles  . . XSetClipRectangles 

context  to  the  specified  region  . XSetRegion 

context  type  (not  graphics/  .......................  XSaveContext 

control  XSetAccessControl:  . XSetAccessControl 

Control,  etc.)  /obtain  a  ..............................  XGetModifierMapping 

Control,  etc.)  /set  keycodes  — .. — ..........  XSetModifierMapping 

(Control  G)  . XBell 

control  list  XAddHost:  ........ - ..........  XAddHost 

control  list  XAddHosts: . XAddHosts 

control  list  XRemoveHost:  .. — - - ........  XRemoveHost 

control  list  /remove  ...................................  XRemoveHosts 

control  list  to  allow  or  deny / . XEnableAccessControl 

control  the  behavior  of  keyboard . XAllowEvents 

convert  a  key  string  to  a/ ...........................  XrmStringToBindingQuarkList 

convert  a  key  string  to  a  quark . XrmStringToQuarkList 

convert  a  keycode  to  a  keysym . XKeycodeToKeysym 

convert  a  keysym  name  string  to  . XStringToKeysym 

convert  a  keysym  symbol  to  a  ..................  XKeysymToString 

convert  a  keysym  to  the  ............................  XKeysymToKeycode 

convert  a  quark  to  a  string  . XrmQuarkToString 

convert  a  string  to  a  quark  ....... _ ...........  XrmStringToQuark 

coordinate  system  from  one  ..... _ .....  XTranslateCoordinates 

copy  a  colormap  and  return  a  new . XCopyColormapAndFree 

copy  a  graphics  context . XCopyGC 
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a  location  within/  XGetSublmage: 
drawable  into  a/  XCopy Plane: 

XCopyArea: 
XLookupKeysym:  get  the  keysym 
XSaveContext:  save  a  data  value 
format/  XCreateBitmapFromData: 

XCreateColormap: 
XCreateGlyphCursor: 
standard/  XCreateFontCursor: 
XCreatePixmapCursor: 
XrmGetStringDatabase: 
mapping/  XNewModifiermap: 
(X10)  XCreateAssocTable: 
graphics/  XUniqueContexl: 

XCreateRegion: 
for  a  given  screen/  XCreateGC: 

XCreatePixmap: 

XCreatePixmapFromBitmapData: 

an  image  XSublmage: 
attributes  XCreateWindow: 
association  table  XMakeAssoc: 
window  XCreateSimpleWindow: 
XGctWindow Attributes:  obtain  the 
context  XSetFont:  set  the 
XGetFontPath:  get  the 
XGetGeometry:  obtain  the 
XGetlnputFocus:  return  the 
/obtain  a  list  of  the 
XQueryPointer:  get  the 
XGetPointerControl:  get  the 
XGetScreenSaver:  get  the 
/obtain  a  bit  vector  for  the 
XFreeCursor:  release  a 
change  the  color  of  a 
a  cursor  from  the  standard 
XUndefineCursor:  disassociate  a 
XCreateGlyphCursor:  create  a 
XCreateFontCursor:  create  a 
XCreatePixmapCursor:  create  a 
get  the  closest  supported 
/obtain  the  "best"  supported 
XDefineCursor:  assign  a 
X10)  XDraw:  draw  a  polyline  or 
X10)  /draw  a  Filled  polygon  or 
XFetchBuffer:  return  data  from  a 
XStoreBuffer:  store  data  in  a 
XFetchBytes:  return  data  from 
XStoreBytes:  store  data  in 
XRotateBuffers:  rotate  the 
/set  a  pattern  of  line 
a  bitmap  from  X 1 1  bitmap  format 
a  pixmap  with  depth  from  bitmap 
specified/  /free  the  in-memory 
XFetchBuffer:  return 
XLookUpAssoc:  obtain 
XFetchBytes:  return 
(not  graphics/  XFindContext:  get 
XStoreBuffer:  store 


copy  a  rectangle  in  drawable  to  ................  XGetSublmage 

copy  a  single  plane  of  a  ............................  XCopyPlane 

copy  an  area  of  a  drawable . XCopyArea 

corresponding  to  a  keycode  in/ - ......  XLookupKeysym 

corresponding  to  a  window  and/ . XSaveContext 

create  a  bitmap  from  X 1 1  bitmap  ............  XCreateBitmapFromData 

create  a  colormap . XCreateColormap 

create  a  cursor  from  font  glyphs  . . XCreateGlyphCursor 

create  a  cursor  from  the  ............................  XCreateFontCursor 

create  a  cursor  from  two  bitmaps . XCreatePixmapCursor 

create  a  database  from  a  string  .................  XrmGetStringDatabase 

create  a  keyboard  modifier . XNewModifiermap 

create  a  new  association  table  ..................  XCreateAssocTable 

create  a  new  context  ID  (not . XUniqueContext 

create  a  new  empty  region  — .... - .........  XCreateRegion 

create  a  new  graphics  context  ..................  XCreateGC 

create  a  pixmap  .........................................  XCreatePixmap 

create  a  pixmap  with  depth  from/ - XCreatePixmapFromBitmapData 

create  a  subimage  from  part  of  .................  XSublmage 

create  a  window  and  set ............................  XCreateWindow 

create  an  entry  in  an . XMakeAssoc 

create  an  unmapped  InputOutput . .  XCreateSimpleWindow 

current  attributes  of  window . XGetWindow Attributes 

current  font  in  a  graphics  ..........................  XSetFont 

current  font  search  path  . XGetFontPath 

current  geometry  of  drawable  . XGetGeometry 

current  keyboard  focus  window . XGetlnputFocus 

current  keyboard  preferences . XGetKeyboardControl 

current  pointer  location . XQueryPointer 

current  pointer  preferences . XGetPointerControl 

current  screen  saver  parameters . XGetScreenSaver 

current  state  of  the  keyboard . XQueryKeymap 

cursor  . XFreeCursor 

cursor  XRecolorCursor: . XRecolorCursor 

cursor  font  /create . XCreateFontCursor 

cursor  from  a  window . XUndefineCursor 

cursor  from  font  glyphs  . XCreateGlyphCursor 

cursor  from  the  standard  cursor/ . XCreateFontCursor 

cursor  from  two  bitmaps . XCreatePixmapCursor 

cursor  sizes  XQueryBestCursor:  . XQueryBestCursor 

cursor,  tile,  or  stipple  size . XQueryBestSize 

cursor  to  a  window . XDefineCursor 

curve  between  vertex  list  (from . XDraw 


curve  irom  vertex  list  t,irom  . 

rut  huffer . 

..  XFetchBuffer 

cut  buffer . . . . 

cut  buffer  0  ................................ 

......  XFetchBytes 

cut  buffer  0  . 

. XStoreBytes 

cut  buffers  . . . 

dashes  in  a  graphics  context .....................  XSetDashes 

data  /create . XCreateBitmapFromData 

data,  /create . XCreatePixmapFromBitmapData 

data  associated  with  the  .......... - - - XFreeStringList 

data  from  a  cut  buffer . .  XFetchBuffer 

data  from  an  association  table  ..................  XLookUpAssoc 

data  from  cut  buffer  0  .......... - ......  XFetchBytes 

data  from  the  context  manager  .................  XFindContext 

data  in  a  cut  buffer  ................ - ..........  XStoreBuffer 
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XStoreBytes:  store 
window  and /  XSaveContext:  save  a 
option  value  from  the  resource 
error  messages  from  the  error 
destroy  a  resource 
specification  to  a  resource 
specification  into  a  resource 
XrmGetFileDatabase:  retrieve  a 
XrmGetStringDatabase:  create  a 
Xrm  Parse  Comm  and:  load  a  resource 
/store  a  resource 
/merge  the  contents  of  one 
/return  a  list  of 
XLookupColor:  get 
/a  resource  specification  to  a 
a  resource  specification  into  a 
with  an  image  XDestroylmage: 
with  a  region  X  Destroy  Region: 
or  disable  synchronization  for 
a  colormap  and  install  the 
given  user  geometry  string  and 
/uninstall  a  colormap;  install 
the  default/  XFreeColormap: 
given  window/  XDeleteContext: 

XDeleteProperty: 
association/  XDeleteAssoc: 
X  DeleteModifienmap  Entry : 
access  control  list  to  allow  or 
that  matches  the  desired 
a  drawable  into  a  drawable  with 
/create  a  pixmap  with 
/for  a  given  screen  with  the 
XListDepths:  determine  the 
XGetErrorText:  obtain  a 
information  that  matches  the 
remaining/  XKill Client: 
Xrm  Destroy  Database: 
X  Destroy  Window:  unmap  and 
window  XDcstroySubwindows: 
modifier/  XFreeModifiermap: 
region  XPointlnRegion: 
in  a  region  XRectlnRegion: 

XEmptyRegion: 
the  same  size,/  XEqualRegion: 
on  a  given  screen  XListDepths: 
XXorRegion:  calculate  the 
XSetAccessControl: 
XSynchronize:  enable  or 
window  XUndefineCurson 
an  X  server  and/  XCloseDisplay: 
XDrawSegments:  draw  multiple 
read  a  bitmap  from 
program  from  an  X  server  and 
of  hosts  having  access  to  this 
XFlush:  flush  the  request  buffer 
name  (when  connection  to  a 
a/  XDisplayName:  report  the 
XSetlconName:  set  the  name  to  be 


data  in  cut  buffer  0  ....................................  XStoreBytes 

data  value  corresponding  to  a . XSaveContext 

database  /extract  an  . XGetDefault 

database  /obtain  . XGetErrorDatabaseText 

database.  XrmDestroyDatabase:  .............  XrmDestroyDatabase 

database  /add  a  resource  ..........................  XrmPutLineResource 

database  /store  a  resource  . XrmPutResource 

database  from  a  file  . . XrmGetFileDatabase 

database  from  a  string  ...............................  XrmGetStringDatabase 

database  from  command  line/ . XrmParseCommand 

database  in  a  file . . XrmPutFileDatabase 

database  into  another  ....... - ........ — ....  XrmMergeDatabases 

database  levels  ...........................................  XrmQGelSearchList 

database  RGB  values  and  closest/ ............  XLookupColor 

database  using  a  quark  resource/  .............  XrmQPutStringResource 

database  using  quarks  /store  ....................  XrmQPutResource 

deallocate  memory  associated  ..................  XDestroylmage 

deallocate  storage  associated . XDestroyRegion 

debugging  XSynchronize:  enable  . XSynchronize 

default  colormap  /delete . XFreeColormap 

default  geometry  /geometry . XGeometry 

default  if  not  already  installed . XUninstallColormap 

delete  a  colormap  and  install . XFreeColormap 

delete  a  context  entry  for  a  . XDeleteContext 

delete  a  window  property  . XDeleteProperty 

delete  an  entry  from  an  . XDeleteAssoc 

delete  an  entry  from  an/ . XDeleteModifiermapEntry 

deny  connection  requests  /use . XEnableAccessControl 

depth  and  class  /information  ....................  XMatchVisuallnfo 

depth,  applying  pixel  values  /of . XCopy Plane 

depth  from  bitmap  data . XCreatePixmapFromBitmapData 

depth  of  the  specified  drawable  . XCreateGC 

depths  available  on  a  given/ . XListDepths 

description  of  error  code . XGetErrorText 

desired  depth  and  class  /visual  . XMatchVisuallnfo 

destroy  a  client  or  its . XKillClient 

destroy  a  resource  database . XrmDestroyDatabase 

destroy  a  window  and  all/ . XDestroyWindow 

destroy  all  subwindows  of  a . XDestroySubwindows 

destroy  and  free  a  keyboard  . XFreeModifiermap 

determine  if  a  point  is  inside  a . XPointlnRegion 

determine  if  a  rectangle  resides . XRectlnRegion 

determine  if  a  region  is  empty . XEmptyRegion 

determine  if  two  regions  have . XEqualRegion 

determine  the  depths  available . XListDepths 

difference  between  the  union  and /  ...........  XXorRegion 

disable  or  enable  access  control . XSetAccessControl 

disable  synchronization  for/  ........... - XSynchronize 

disassociate  a  cursor  from  a  .............. — ....  XUndefineCursor 

disconnect  a  client  program  from  . XCloseDisplay 

disjoint  lines ...............................................  XDrawSegments 

disk  XReadBitmapFile: ............................  XReadBitmapFile 

display  /disconnect  a  client . XCloseDisplay 

display  /obtain  a  list . XListHosts 

(display  all  queued  requests)  ....................  XFlush 

display  fails)  /the  display  . .  XDisplayName 

display  name  (when  connection  to  . XDisplayName 

displayed  in  a  window’s  icon  ...................  XSetlconName 
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XGetlconName:  get  the  name  to  be 
next  event  that  matches  mask; 
queue  that  matches  event  type; 
passed  window  and  passed  mask; 
sucking  order  of  children  up  or 
/change  the  close 
characters  XDrawImageStringl6: 

XDrawTextl6: 
XDra  wlmageString : 

XDrawText: 
from  vertex  list/  XDrawFilled: 

XDrawLine: 

XDrawPoint: 
vertex  list  (from  X10)  XDraw: 
foreground  only  XDrawString: 

rectangle  XDrawArc: 
pixmap  XPutlmage: 
XDrawRecUngle: 

XDrawArcs: 

XDrawLines: 

XDrawSegments: 

XDrawPoints: 
recungles  XDrawRecUngles: 

XDrawString  16: 
XCopyArea:  copy  an  area  of  a 
with  the  depth  of  the  specified 
obuin  the  current  geometry  of 
depth  y  /copy  a  single  plane  of  a 
contents  of  a  recungle  from 
the/  /copy  a  recungle  in 
/plane  of  a  drawable  into  a 
XSetLine Attributes:  set  the  line 
determine  if  a  region  is 
XCreateRegion:  create  a  new 
XSetAccessControl:  disable  or 
synchronization/  XSynchronize: 
generate  the  smallest  recungle 
XClearWindow:  clear  an 
XDcleteContext:  delete  a  context 
XDeleteAssoc:  delete  an 
structure  /delete  an 
XMake Assoc:  create  an 
structure  /add  a  new 
/values  of  a  read/write  colormap 
obuin  a  description  of 
/obuin  error  messages  from  the 
XSetErrorHandler:  set  a  nonfaul 
XGetErrorDaubaseText:  obuin 
/and  wait  for  all  events  and 
modifier  keys  (Shift,  Control, 
as  modifiers  (Shift,  Control, 
the  event  queue  for  a  matching 
XSendEvent:  send  an 
XPulBackEvent:  push  an 
set  a  nonfatal  error 
window  /return  the  next 
event  type;/  /return  the  next 
procedure/  XPeeklfEvent:  get  an 


displayed  in  an  icon  . 

don’t  wait  /remove  the  ................... 

don’t  wait  /the  next  event  in  .......... 

don’t  wait  /event  matching  both  .... 

down  /circulate  the  .................. _ _ 

down  mode  of  a  client ..................... 

draw  16-bil  image  text  _ _ _ _ 

draw  16-bit  polytext  strings _ 

draw  8-bit  image  text  characters  .... 

draw  8-bit  polytext  strings  _ _ ......... 

draw  a  filled  polygon  or  curve . 

draw  a  line  between  two  points  ...... 

draw  a  point . 

draw  a  polyline  or  curve  between  .. 
draw  an  8-bit  text  string, ................. 

draw  an  arc  fitting  inside  a  . 

draw  an  image  on  a  window  or  ...... 

draw  an  outline  of  a  recungle . 

draw  multiple  arcs  ................... _ ... 

draw  multiple  connected  lines . 

draw  multiple  disjoint  lines  . 

draw  multiple  points . 

draw  the  outlines  of  multiple  .......... 

draw  two-byte  text  strings  .............. 

d  ra  wable . .................................... 

drawable  /for  a  given  screen . 

drawable  XGetGeometry:  . 

drawable  into  a  drawable  with  . 

drawable  into  an  image  /place  . 

drawable  to  a  location  within  . 

drawable  with  depth,  applying/ . 

drawing  components  in  a  graphics/ 

empty  XEmptyRegion:  . 

empty  region . 

enable  access  control  . 

enable  or  disable . 

enclosing  a  region  XClipBox:  . 

entire  window . 

entry  for  a  given  window  and/ . 

entry  from  an  association  uble . 

entry  from  an  XModificrKeymap  ... 

entry  in  an  association  uble  . . 

entry  to  an  XModifierKeymap . . 

entry  to  the  closest  possible/ . . 

error  code  XGetErrorText: . . 

error  daubase  . . 

error  event  handler  ........................... 

error  messages  from  the  error/  ........ 

errors  to  be  processed  by  the/ . . 

etc.)  /obuin  a  mapping  of  .. . . 

etc.)  /set  keycodes  to  be  used . 

event  XChecklfEvent:  check  .......... 

event . . 

event  back  on  the  input  queue . 

event  handler  XSetErrorHandler:  ... 
event  in  queue  matching  type  and  .. 

event  in  queue  that  matches  . . 

event  matched  by  predicate  . . 


...........  XGetlconName 

. XCheckMaskEvent 

..........  XCheckTypedEvent 

..........  XCheckWindowEvent 

..........  XCirculateSubwindows 

- XSetCloseDownMode 

..........  X  DrawImageString  1 6 

. . XDrawTextl6 

...........  XDrawImageString 

— ......  XDrawText 

...........  XDrawFilled 

...........  XDrawLine 

...........  XDrawPoint 

, — .....  XDraw 

...........  XDrawString 

...........  XDrawArc 

..........  XPutlmage 

. . XDrawRecUngle 

..........  XDrawArcs 

. XDrawLines 

. XDrawSegments 

..........  XDrawPoints 

. XDrawRecUngles 

..........  XDrawString  16 

. XCopyArea 

..........  XCreateGC 

..........  XGetGeometry 

. XCopyPlane 

. XGetlmage 

. XGetSublmage 

. XCopyPlane 

XSelLineAttributes 

. XEmptyRegion 

. XCreateRegion 

. XSetAccessControl 

. XSynchronize 

. XClipBox 

...... _ XClearWindow 

. XDcleteContext 

. XDeleteAssoc 

. XDeleteModifiermapEntry 

. XMakeAssoc 

. XInsertModificrmapEntry 

. XStoreColor 

. XGetErrorText 

. XGetErrorDaubaseText 

. XSetErrorHandler 

. . XGetErrorDaubaseText 

..........  XSync 

..........  XGetModifierMapping 

. XSetModifierMapping 

..........  XChecklfEvent 

. . XSendEvent 

..........  XPutBack  Event 

..........  XSetErrorHandler 

. XCheckTypedWindowEvent 

..........  XCheckTypedEvent 

..........  XPeeklfEvent 
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procedure  XlfEvent:  wait  for  event  matched  in  predicate  . . XlfEvent 

window  and/  /remove  the  next  event  matching  both  passed  - - ....  XCheckWindowEvent 

XNextEvent:  get  the  next  event  of  any  type  or  window . .  XNextEvent 

the  number  of  events  in  the  event  queue  /check  ...................................  XEventsQueued 

XChecklfEvent:  check  the  event  queue  for  a  matching  event  - - XChecklfEvent 

XMaskEvent:  remove  the  next  event  that  matches  mask  ...........................  XMaskEvent 

XChcckMaskEvent:  remove  the  next  event  that  matches  mask;  don’t/ - - ....  XCheckMaskEvent 

XWindowEvent:  remove  the  next  event  that  matches  the  specified/  .............  XWindowEvent 

and /  X LookupString:  map  a  key  event  to  ASCII  string,  keysym,  ................  XLookupString 

next  event  in  queue  that  matches  event  type;  don’t  wait  /the . .  XCheckTyped Event 

window  XSelectlnput:  select  the  event  types  to  be  sent  to  a  ........ - ......  XSelectlnput 

the  queue  XPeekEvent:  get  an  event  without  removing  it  from . XPeekEvent 

the  number  of  pending  input  events  /buffer  and  return  ..........................  XPending 

request  buffer  and  wait  for  all  events  and  errors  to  be/  /the  ......... — .......  XSync 

history/  XGetMotionEvents:  get  events  from  pointer  motion  . XGetMotion Events 

/check  the  number  of  events  in  the  event  queue . XEventsQueued 

/behavior  of  keyboard  and  pointer  events  when  these  resources  are/ . XAllowEvents 

server  XNoOp:  send  a  NoOp  to  exercise  connection  with  the . XNoOp 

XShrinkRegion:  reduce  or  expand  the  size  of  a  region . XShrinkRegion 

XQuery Extension:  get  extension  information  ...............................  XQueryExtension 

for  a  list  of  installed  extensions  /memory  allocated  .................  XFreeExtensionList 

Xlib  and/  /return  a  list  of  all  extensions  to  X  supported  by . XListExtensions 

resource  database  XGetDefault:  extract  an  option  value  from  the  . XGetDefault 

(when  connection  to  a  display  fails)  /report  the  display  name  . XDisplayName 

XQuery BestTile:  obtain  the  fastest  supported  fill  tile/ . XQuery BestTile 

XQueryBestStipple:  obtain  the  fastest  supported  stipple  shape . XQueryBcstStipple 

retrieve  a  database  from  a  file  XrmGetFilcDatabase:  . XrmGetFileDatabase 

store  a  resource  database  in  a  file  XrmPutFileDatabase: . XrmPutFileDatabase 

write  a  bitmap  to  a  File  XWriteBitmapFile: . XWriteBitmapFile 

XFillPolygon:  fill  a  polygon  . XFillPolygon 

XFillRectangle:  fill  a  rectangular  area  . XFillRectangle 

XFillArc:  fill  an  arc . . . X  Fill  Arc 

XLoadQueryFont:  load  a  font  and  fill  information  structure  ...........................  XLoadQucryFont 

XFillArcs:  fill  multiple  arcs . XFillArcs 

XFillRectangles:  fill  multiple  rectangular  areas . XFillRectangles 

XSetFillRule:  set  the  fill  rule  in  a  graphics  context . XSetFillRule 

XSetFillStyle:  set  the  fill  style  in  a  graphics  context . XSetFillStyle 

XSetTile:  set  the  fill  tile  in  a  graphics  context . XSetTile 

obtain  the  fastest  supported  fill  tile  shape  XQuery  BestTile: - XQueryBestTile 

vertex  list/  XDrawFilled:  draw  a  filled  polygon  or  curve  from  . XDrawFilled 

structures  that/  XGetVisuallnfo:  find  the  visual  information  . XGetVisuallnfo 

XDrawArc:  draw  an  arc  fitting  inside  a  rectangle . XDrawArc 

/obtain  the  RGB  values  and  flags  for  a  specified  colorcell . XQueryColor 

return  the  number  of/  XPending:  flush  the  request  buffer  and . XPending 

wait  for  all  events  and/  XSync:  flush  the  request  buffer  and . XSync 

(display  all  queued/  XFlush:  flush  the  request  buffer . XFlush 

return  the  current  keyboard  focus  window  XGetlnputFocus: . XGetlnputFocus 

XSetlnputFocus:  set  the  keyboard  focus  window  . XSetlnputFocus 

cursor  from  the  standard  cursor  font  /create  a . XCreateFontCursor 

information  about  a  loaded  font  XQueryFont:  return  . XQueryFont 

XUnloadFont:  unload  a  font . XUnloadFont 

XLoadQueryFont:  load  a  font  and  fill  information/ . .  XLoadQueryFont 

font/  XFreeFont:  unload  a  font  and  free  storage  for  the  ......... — ......  XFreeFont 

create  a  cursor  from  font  glyphs  XCreateGlyphCursor:  ..........  XCreateGlyphCursor 

font  if  not  already  loaded;  get  font  ID  XLoadFont:  load  a . —  XLoadFont 

font  ID  XLoadFont:  load  a  font  if  not  already  loaded;  get  . XLoadFont 

XSetFont:  set  the  current  font  in  a  graphics  context  .........................  XSetFont 

query  the  server  for  string  and  font  metrics  XQuery TextExtents:  ..... - XQuery TextExtents 
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XTextExtents:  get  string  and 
/query  the  server  for  string  and 
XTextExtentsl6:  get  string  and 
return  a  list  of  the  available 
XGetFontProperty:  get  a 
XGetFontPath:  get  the  current 
XSetFoniPath:  set  the 
a  font  and  free  storage  for  the 
and  information  about  loaded 
function,/  XSetState:  set  the 
draw  an  8-bit  text  string, 
XSetForeground:  set  the 
/create  a  bitmap  from  XI 1  bitmap 
the  atom  type  and  property 
/obtain  the  supported  pixmap 
XFreeGC: 

XFreeModifiermap:  destroy  and 
XFreePixmap: 

XFreeColors: 
of/  XFreeExtensionList: 
by  an  Xlib  function  XFree: 
XFreeFont:  unload  a  font  and 
associated/  XFreeStringList: 
XGetFontPath  XFreeFontPath: 
XListFonts.  XFreeFontNames: 

XFreeFontlnfo: 
association/  XDestroyAssocTable: 
allocate  memory  never  to  be 
memory  allocated  by  an  Xlib 
/foreground,  background,  logical 
XSetAfterFunction:  set  a 
a  function  called  after  all  Xlib 
XBell:  ring  the  bell  (Control 
of  a  given  GC  from  Xlib’s 
/obtain  components  of  a  given 
XGContextFromGC:  obtain  the 
XPolygonRegion: 
standard  window/  XParseGeometry: 
enclosing  a  region  XClipBox: 
user  geometry  string  and  default 
XGeometry:  calculate  window 
XWM Geometry:  obtain  a  window’s 
XGetGeometry:  obtain  the  current 
and  size  from  standard  window 
/window  geometry  given  user 
atom  XGetFontProperty: 
XListlnstalledColormaps : 
class  as/  XrmGetResource: 
and  class  as/  XrmQGetResource: 
given  its  atom  XGetAtomName: 
property)  XFetchName: 
predicate/  XPeeklfEvent: 
from  the  queue  XPeekEvent: 
manager  (not /  XFindContext: 

closest/  XLookupColor: 
history/  XGetMotion Events: 

XQuery  Ex  tension: 
a  font  if  not  already  loaded; 


..  XTextExtents 
XQueryTextExtentsl6 
..  XTextExtents  16 


font  metrics  locally  . . 

font  metrics  of  a  16-bit/ _ _ 

font  metrics  of  a  16-bit/ _ ..... _ 

font  names  XListFonts: _ ... _ XListFonts 

font  property  given  its  atom  - XGetFontProperty 

font  search  path  _ XGetFontPath 

font  search  path  . . . . ... _ _ XSetFontPath 

font  structure  /unload  . . XFreeFont 

fonts  /obtain  the  names  - ... _ XListFonts Withlnfo 

foreground,  background,  logical ..............  XSetState 

foreground  only  X  Draw  String:  ... _ XDrawStnng 

foreground  pixel  value  in  a/ _ XSetForeground 

format  data  . — ......  XCreateBitmapFromData 

format  for  a  window  /obtain  . . XGetWindowProperty 

formats  for  a  given  server  ............. - XListPixmapFormats 

free  a  graphics  context ... . . XFreeGC 

free  a  keyboard  modifier  mapping/ . XFreeModifiermap 

free  a  pixmap  ID  ........................................  XFreePixmap 

free  colormap  cells  or  planes  _ _ _ _ XFreeColors 

free  memory  allocated  for  a  list  XFreeExtensionList 

free  specified  memory  allocated  . .  XFree 

free  storage  for  the  font / _ _ _ _ _ XFreeFont 

free  the  in-memory  data . XFreeStringList 

free  the  memory  allocated  by  . . XFreeFontPath 

free  the  memory  allocated  by . XFreeFontNames 

free  the  memory  allocated  by/ . XFreeFontlnfo 

free  the  memory  allocated  for  an  _ XDestroyAssocTable 

freed  Xpermalloc: . Xpermalloc 

function  XFree:  free  specified . XFree 

function,  and  plane  mask  in  a / . XSetState 

function  called  after  all  Xlib/ . XSetAfterFunction 

functions  /set ............... . . XSetAfterFunction 

G) . . . . .  XBell 

GC  cache  /obtain  components . XGetGCValues 

GC  from  Xlib’s  GC  cache  . XGetGCValues 

GContext  (resource  ID)/ . . XGContextFromGC 

generate  a  region  from  points . XPolygonRegion 

generate  position  and  size  from  . XParseGeometry 

generate  the  smallest  rectangle  . . XClipBox 

geometry  /window  geometry  given . XGeometry 

geometry  given  user  geometry/ ... . . XGeometry 

geometry  information  . XWMGeometry 

geometry  of  drawable  . . XGetGeometry 

geometry  string  /position  . . .. . XParseGeometry 

geometry  string  and  default/ . XGeometry 

get  a  font  property  given  its . XGetFontProperty 

get  a  list  of  installed/ . XListlnstalledColormaps 

get  a  resource  from  name  and  . XrmGetResource 

get  a  resource  value  using  name  . XrmQGetResource 

get  a  string  name  for  a  property  . XGetAtomName 

get  a  window’s  name  (XA_WM_NAME .  XFetchName 
get  an  event  matched  by  ...........................  XPeeklfEvent 

get  an  event  without  removing  it . . XPeekEvent 

get  data  from  the  context - - XFindContext 

get  database  RGB  values  and  ......... _ _ _ XLookupColor 

get  events  from  pointer  motion  ... — . XGetMotionEvents 

get  extension  information  ... - ......  XQueryExtension 

get  font  ID  XLoadFont:  load  - - -  XLoadFont 
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XGetlconSizes: 
locally  XTextExtents: 
16-bit/  XTextExtentsl6: 
sizes  XQueryBestCursor: 

XGetFontPath: 
XQueryPointer: 
preferences  XGetPointerControl: 

parameters  XGetScrcenSaver: 
a  key  code  in/  XLookupKeysym: 
an  icon  XGetlconName: 
or  window  XNextEvent: 

XGetPointerMapping : 
window  XListProperties: 
window  in /  XGetNormalHints: 
property  XGetStandardColormap: 
16-bit  character/  XTextWidthl6: 
8-bit  character/  XTextWidth: 
a  window  XGetaassHint: 
property/  XGetTransientForHint: 
create  a  cursor  from  font 
parameters  of  an  active  pointer 
release  a  button  from  a  passive 
release  a  key  from  a  passive 
the  keyboard  from  an  active 
the  pointer  from  an  active 
release  the  server  from 
XGrabKey: 

XGrabButton: 

XGrabKeyboard: 

XGrabPointer: 

XGrabServer: 
events  when  these  resources  are 
change  the  components  of  a  given 
XCopyGC:  copy  a 
from  the  context  manager  (not 
XFreeGC:  free  a 
associated  with  the  specified 
a  window  and  context  type  (not 
set  the  arc  mode  in  a 
the  background  pixel  value  in  a 
set  clip_mask  pixmap  in  a 
/set  the  clip  origin  in  a 
a  pattern  of  line  dashes  in  a 
set  the  fill  rule  in  a 
set  the  fill  style  in  a 
set  the  current  font  in  a 
the  foreground  pixel  value  in  a 
bitwise  logical  operation  in  a 
/component  in  a 
the  line  drawing  components  in  a 
set  the  plane  mask  in  a 
function,  and  plane  mask  in  a 
set  the  stipple  in  a 
/set  the  subwindow  mode  in  a 
XSetTile:  set  the  fill  tile  in  a 
set  the  tile/stipple  origin  in  a 
/create  a  new  context  ID  (not 
screen/  XCreateGC:  create  a  new 


get  preferred  icon  sizes  .............................  XGetlconSizes 

get  string  and  font  metrics  ........................  XTextExtents 

get  string  and  font  metrics  of  a  .................  XTextExtents  16 

get  the  closest  supported  cursor . .  XQueryBestCursor 

get  the  current  font  search  path  ................  XGetFontPath 

get  the  current  pointer  location  . XQueryPointer 

get  the  current  pointer  .............. — .............  XGetPointerControl 

get  the  current  screen  saver . XGetScrcenSaver 

get  the  keysym  corresponding  to  . . XLookupKeysym 

get  the  name  to  be  displayed  in  ................  XGetlconName 

get  the  next  event  of  any  type  . XNextEvent 

get  the  pointer  button  mapping  - XGetPointerMapping 

get  the  property  list  for  a . XListProperties 

get  the  size  hints  property  of  a  . XGetNormalHints 

get  the  standard  colormap . XGetStandardColormap 

get  the  width  in  pixels  of  a  ........................  XTextWidth  16 

get  the  width  in  pixels  of  an  . XTextWidth 

get  the  XA_WM_CLASS  properly  of  .....  XGetaassHint 

get  the  XA_WM_TRANSIENT_FOR . XGetTransientForHint 

glyphs  XCrcateGlyphCursor:  .... — ..........  XCreateGlyphCursor 

grab  /change  the . XChangeActivePointerGrab 

grab  XUngrabButton: . XUngrabButton 

grab  XUngrabKey: . XUngrabKey 

grab  XUngrabKeyboard:  release  .............  XUngrabKey  board 

grab  XUngrabPointer:  release  . XUngrabPointer 

grab  XUngrabServer: . XUngrabServer 

grab  a  key  . XGrabKey 

grab  a  pointer  button . XGrabButton 

grab  the  keyboard . XGrabKeyboard 

grab  the  pointer  . XGrabPointer 

grab  the  server . XGrabServer 

grabbed  /of  keyboard  and  pointer . XAllowEvents 

graphics  context  XChangeGC: . XChangeGC 

graphics  context . XCopyGC 

graphics  context)  /get  data . XFindContext 

graphics  context  . XFreeGC 

graphics  context  /(resource  ID)  ...............  XGContextFromGC 

graphics  context)  /to . XSaveContext 

graphics  context  XSetArcMode: . XSetArcMode 

graphics  context  /set . XSelBackground 

graphics  context  XSetClipMask: . XSetGipMask 

graphics  context . . . XSetClipOrigin 

graphics  context  /set . XSelDashes 

graphics  context  XSetFillRule: . XSetFillRule 

graphics  context  XSetFillStyle: . XSetFillStyle 

graphics  context  XSetFont:  — . — - - XSetFont 

graphics  context  /set .................................  XSetForeg round 

graphics  context  /set  the  ...........................  XSetFunction 

graphics  context  . . XSetGraphicsExposures 

graphics  context  /set .......................... — ...  XSetlineAttributes 

graphics  context  XSetPlaneMask:  ..........  XSetPlaneMask 

graphics  context  /logical . XSctState 

graphics  context  XSetStipple:  . XSetStipple 

graphics  context  ........................................  XSetSubwindowMode 

graphics  context . XSetTile 

graphics  context  XSetTSOrigin:  . XSetTSOrigin 

graphics  context) ............................. — ....  XUniqueContext 

graphics  context  for  a  given  .....................  XCreateGC 
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/change  clip_mask  in  a  graphics  context  to  a  list  of/ _ XSetClipRectangles 

XSetRegion:  set  clip_mask  of  the  graphics  context  to  the/ _ _ _ XSetRegion 

XSetGraphicsExposures:  set  the  graphics_exposurcs  component  in/ . XSetGraphicsExposures 

set  a  nonfatal  error  event  handler  XSetErrorHandlen . XSetErrorHandler 

entry  to  the  closest  possible  hardware  color  /colormap  ........................  XStoreColor 

to  the  closest  possible  hardware  colors  /colorcells  . . XStoreColors 

/colormap  cell  with  closest  hardware-supported  color . XAllocColor 

/database  RGB  values  and  closest  hardware-supported  RGB  values/ . XLookupColor 

/obtain  a  list  of  hosts  having  access  to  this  display  ....................  XUstHosts 

ASCH  color  name  or  translate  hexadecimal  value  /values  from  ..............  XParseColor 

read  the  window  manager  hints  property  XGetWMHints:  .......... _ XGetWMHints 

set  a  window  manager  hints  property  XSelWMHints: . XSetWMHints 

XGetNormalHints:  get  the  size  hints  property  of  a  window  in/ . XGetNormalHints 

XSetNormalHints:  set  the  size  hints  property  of  a  window  in/  .................  XSetNormalHints 

XGetZoomHints:  read  the  size  hints  property  of  a  zoomed/ _ ....  XGetZoomHints 

XSetZoomHints:  set  the  size  hints  property  of  a  zoomed/ ... _ _ _ XSetZoomHints 

/get  events  from  pointer  motion  history  buffer . . XGetMotionEvents 

allow  access  from  any  host  XDisableAccessControl: . . XDisableAccessControl 

list  XRemoveHost:  remove  a  host  from  the  access  control  .....................  XRemoveHost 

XAddHost:  add  a  host  to  the  access  control  list . XAddHost 

XRemoveHosts:  remove  multiple  hosts  from  the  access  control/  ...... _ XRemoveHosts 

XListHosts:  obtain  a  list  of  hosts  having  access  to  this/ . XListHosts 

XAddHosts:  add  multiple  hosts  to  the  access  control  list . XAddHosts 

the  name  to  be  displayed  in  an  icon  XGetlconName:  get . XGetlconName 

to  be  displayed  in  a  window’s  icon  XSetlconName:  set  the  name . XSetlconName 

XGetlconSizes:  get  preferred  icon  sizes . XGetlconSizes 

in  normal  state  (not  zoomed  or  iconified)  /property  of  a  window . XGetNormalHints 

that  a  top-level  window  be  iconified  /request . XlconifyWindow 

in  normal  state  (not  zoomed  or  iconified)  /property  of  a  window . XSetNormalHints 

and  return  a  new  colormap  ID  /copy  a  colormap . XCopyColormapAndFree 

XFreePixmap:  free  a  pixmap  ID . XFrcePixmap 

if  not  already  loaded;  get  font  ID  XLoadFont:  load  a  font . XLoadFont 

/obtain  the  GContext  (resource  ID)  associated  with  the/ . XGContextFromGC 

/obtain  the  visual  ID  from  a  Visual . XVisuallDFromVisual 

/create  a  new  context  ID  (not  graphics  context) . XUniqueContext 

value  to  every  pixel  value  in  an  image  XAddPixel:  add  a  constant . XAddPixel 

memory  associated  with  an  image  XDestroylmage:  deallocate  . XDestroylmage 

rectangle  from  drawable  into  an  image  /place  contents  of  a . XGetlmage 

a  single  pixel  value  from  an  image  XGetPixel:  obtain . XGetPixel 

location  within  the  pre-existing  image  /in  drawable  to  a . XGetSublmage 

set  a  pixel  value  in  an  image  XPutPixel: . XPutPixel 

a  subimage  from  part  of  an  image  XSublmage:  create . XSublmage 

XPutlmage:  draw  an  image  on  a  window  or  pixmap . XPutlmage 

XDrawImageString:  draw  8-bit  image  text  characters  . XDrawImageString 

XDrawImageString  16:  draw  16-bit  image  text  characters  . XDrawImageString  16 

XQuery Extension:  get  extension  information  . XQueryExtension 

obtain  a  window’s  geometry  information  XWMGeometry: . XWMGeometry 

XQueryFont:  return  information  about  a  loaded  font . XQueryFont 

/obtain  the  names  and  information  about  loaded  fonts  . XListFontsWithlnfo 

/load  a  font  and  fill  information  structure . . XLoadQueryFont 

XGetVisuallnfo:  find  the  visual  information  structures  that/ . XGetVisuallnfo 

desired  depth/  /obtain  the  visual  information  that  matches  the . XMatchVisuallnfo 

Xrmlnitialize:  initialize  the  resource  manager . Xrmlnitialize 

the/  XFreeStringList:  free  the  in-memory  data  associated  with  ...............  XFreeStringList 

and  return  the  number  of  pending  input  events  /the  request  buffer  ...............  XPending 

push  an  event  back  on  the  input  queue  XPutBackEvent:  . XPutBackEvent 

/create  an  unmapped  InputOutput  window  .................................  XCreateSimpleWindow 

window  and  its/  XReparentWindow:  insert  a  window  between  another . XReparentWindow 
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XDrawArc:  draw  an  arc  fitting 
determine  if  a  point  is 
XlnstallColormap: 
installed  Am  in  stall  a  colormap; 
/delete  a  colormap  and 
install  default  if  not  already 
/get  a  list  of 
memory  allocated  for  a  list  of 
XIntersectRegion:  compute  the 
difference  between  the  union  and 
XGrabKey:  grab  a 
the  keyboard  preferences  such  as 
keysym,/  XLookupString:  map  a 
XUngrabKey:  release  a 
a  quark  list  /convert  a 
XrmStringToQuarkList:  convert  a 
XGrabKeyboard:  grab  the 
for  the  current  state  of  the 
these/  /control  the  behavior  of 
XAutoRepeatOff:  turn  off  the 
XAutoRepeatOn:  turn  on  the 
/return  the  current 
XSetlnputFocus:  set  the 
XUngrabKeyboard:  release  the 
/change  the 
structure  /destroy  and  free  a 
XNewModifiermap:  create  a 
/obtain  a  list  of  the  current 
click  /change  the 
a  keysym  to  the  appropriate 
the  keysym  corresponding  to  a 
XKeycodeTo Keysym:  convert  a 
XRefreshKeyboardMapping:  read 
return  symbols  for 
/obtain  the  range  of  legal 
XSetModifierMapping:  set 
off  the  keyboard  auto-repeat 
turn  on  the  keyboard  auto-repeat 
/obtain  a  mapping  of  modifier 
convert  a  keycode  to  a 
a  keysym  name  string  to  a 
/map  a  key  event  to  ASCII  string, 
keycode/  XLookupKeysym:  get  the 
XStringToKeysym:  convert  a 
XKeysymToString:  convert  a 
XRebindKeysym:  rebind  a 
XKeysymToKeycode:  convert  a 
/obtain  the  range  of 
return  a  list  of  database 
a  resource  database  from  command 
the  XA_WM_COMMAND  atom  (command 
XDrawLine:  draw  a 
XSetDashes:  set  a  pattern  of 
XSetLine Attributes:  set  the 
draw  multiple  connected 
draw  multiple  disjoint 
add  a  host  to  the  access  control 
hosts  to  the  access  control 


inside  a  rectangle  ................................ 

inside  a  region  XPointlnRegion:  ...... 

install  a  colormap  ............................... 

install  default  if  not  already  . — ...... — 

install  the  default  colormap  ........ - 

installed  /uninstall  a  colormap; . 

installed  colormaps  . . 

installed  extensions  /free  ................... 

intersection  of  two  regions  . 

intersection  of  two  regions  /the  ........ 

key  click  /change . 

key  event  to  ASCII  string . 

key  from  a  passive  grab  ..................... 

key  string  to  a  binding  list  and  . 

key  string  to  a  quark  list . 

keyboard  . 

keyboard  /obtain  a  bit  vector . 

keyboard  and  pointer  events  when  ... 

keyboard  auto-repeat  keys . 

keyboard  auto-repeat  keys . 

keyboard  focus  window . 

keyboard  focus  window . 

keyboard  from  an  active  grab . 

keyboard  mapping  . 

keyboard  modifier  mapping . 

keyboard  modifier  mapping/ . 

keyboard  preferences . 

keyboard  preferences  such  as  key  .... 

keycode  /convert  . 

keycode  in  structure  /get . 

keycode  to  a  keysym . 

keycode-keysym  mapping  from/ . 

keycodes  XGetKeyboardMapping: .. 

keycodes  for  a  server  . . 

keycodes  to  be  used  as  modifiers/ . 

keys  XAutoRepeatOff:  turn . 

keys  XAutoRepeatOn:  . 

keys  (Shift,  Control,  etc.) . 

keysym  XKeycodeToKeysym: . 

keysym  XStringToKeysym:  convert 

keysym,  and  ComposeStatus . 

keysym  corresponding  to  a . 

keysym  name  string  to  a  keysym . 

keysym  symbol  to  a  string . 

keysym  to  a  string  for  client . 

keysym  to  the  appropriate/ . 

legal  keycodes  for  a  server . 

levels  XrmQGetSearchList: . 

line  arguments  /load  . . 

line  arguments)  /set  . 

line  between  two  points  . 

line  dashes  in  a  graphics/  ... . 

line  drawing  components  in  a / . 

lines.  XDrawLines: . 

lines  XDrawSegmenls: . ... 

list  XAddHost: . 

list  XAddHosts:  add  multiple  ........... 


XDrawArc 
XPointlnRegion 
......  XlnstallColormap 

. XUninstall  Colormap 

. XFreeColormap 

......  XUninstallColormap 

......  XlistlnstalledColormaps 

......  XFreeExtensionList 

......  XIntersectRegion 

......  XXorRegion 

_ XGrabKey 

. XChangeKeyboardControl 

......  XLookupString 

_ XUngrabKey 

. XrmStringToBindingQuarkList 

. XrmStringToQuarkList 

......  XGrabKeyboard 

......  XQueryKeymap 

. XAllowEvents 

......  XAutoRepeatOff 

......  XAutoRepeatOn 

—  XGetlnputFocus 
......  XSetlnputFocus 

......  XUngrabKeyboard 

. XChangeKeyboardMapping 

......  XFreeModifiermap 

. XNewModifiermap 

. XGetKeyboardControl 

......  XChangeKeyboardControl 

. XKeysymToKeycode 

......  XLookupKeysym 

......  XKeycodeToKeysym 

......  XRefreshKeyboardMapping 

. XGetKeyboardMapping 

. XDisplayKeycodes 

. XSetModifierMapping 

......  XAutoRepeatOff 

. XAutoRepeatOn 

......  XGetModifierMapping 

. XKeycodeToKeysym 

. XStringToKeysym 

. XLookupString 

......  XLookupKeysym 

. XStringToKeysym 

. XKeysymToString 

......  XRebindKeysym 

. XKeysymToKeycode 

. XDisplayKeycodes 

......  XrmQGetSearchList 

. XrmParseCommand 

. XSetCommand 

......  XDrawLine 

......  XSetDashes 

......  XSetUneAttributes 

......  XDrawLines 

......  XDrawSegments 

_ XAddHost 

_ XAddHosts 
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with  the  specified  string 
a  host  from  the  access  control 
hosts  from  the  access  control 
to  a  binding  list  and  a  quark 
convert  a  key  string  to  a  quark 
a  key  string  to  a  binding 
/search  prepared 
/get  the  property 
polyline  or  curve  between  vertex 
polygon  or  curve  from  vertex 
XListExtensions:  return  a 
root  XQueryTree:  return  a 
XrmQGetSearchList:  return  a 
this/  XListHosts:  obtain  a 
XlistlnstalledColormaps:  get  a 
/free  memory  allocated  for  a 
in  a  graphics  context  to  a 
XTextProperty/  /obtain  a 
XTextProperty/  /set  the  specified 
XListFonts:  return  a 
XGetKeyboardControl:  obtain  a 
requests  /use  access  control 
structure  XLoadQueryFont: 
loaded;  get  font  ID  XLoadFont: 
command  line/  XrmParseCommand: 

return  information  about  a 
the  names  and  information  about 
load  a  font  if  not  already 
get  string  and  font  metrics 
of  a  16-bit  character  string, 
of  an  8 -bit  character  string, 
of  a  16-bit  character  string, 
get  the  current  pointer 
/a  rectangle  in  drawable  to  a 
/set  the  foreground,  background, 
XSetFunction:  set  the  bitwise 
color  name  or/  XParseColor: 
order  XLowerWindow: 
initialize  the  resource 
set  of  properties  for  the  window 
name  to  a  window  for  the  window 
XGetWMHints:  read  the  window 
XSetWM Hints:  set  a  window 
/get  data  from  the  context 
/set  a  window’s  standard  window 
keysym,  and/  XLookupString: 

XMapWindow: 
siblings  XMapRaised: 
XMapSubwindows: 
change  the  keyboard 
get  the  pointer  button 
set  the  pointer  button 
/read  keycode-keysym 
XGetModifierMapping:  obtain  a 
and  free  a  keyboard  modifier 
/create  a  keyboard  modifier 
the  next  event  that  matches 
event  that  matches  the  specified 


list  /in -memory  data  associated  ...............  XFreeStringList 

list  XRemoveHosl:  remove . XRemoveHost 

list  /remove  multiple . XRemoveHosts 

list  /convert  a  key  string  ...........................  XrmStringToBindingQuarkList 

list  XrmStringToQuarkList: . XrmStringToQuarkList 

list  and  a  quark  list  /convert . . XrmStringToBindingQuarkList 

list  for  a  given  resource  .............................  XrmQGetSearchResource 

list  for  a  window  ........................................  XListProperties 

list  (from  X10)  XDraw:  draw  a . .  XDraw 

list  (from  X10)  /draw  a  filled  ...................  XDrawFilled 

list  of  all  extensions  to  X/  . — - - - -  XListExtensions 

list  of  children,  parent,  and  .......... _ ......  XQueryTree 

list  of  database  levels  ................................  XrmQGetSearchList 

list  of  hosts  having  access  to  . XListHosts 

list  of  installed  colormaps  . XlistlnstalledColormaps 

list  of  installed  extensions . XFreeExtensionList 

list  of  rectangles  /clip_mask  ....................  XSetClipRectangles 

list  of  strings  from  a  specified  . XTextProperty ToStringList 

list  of  strings  to  an  .....................................  XStringListToTextProperty 

list  of  the  available  font  names . XListFonts 

list  of  the  current  keyboard/ . XGetKeyboardControl 

list  to  allow  or  deny  connection  ...............  XEnableAccessControl 

load  a  font  and  fill  information  . XLoadQueryFont 

load  a  font  if  not  already . XLoadFont 

load  a  resource  database  from . XrmParseCommand 

loaded  font  XQueryFont: . XQueryFont 

loaded  fonts  /obtain . XListFontsWithlnfo 

loaded;  get  font  ID  XLoadFont:  . XLoadFont 

locally  XTextExtents:  .......... - XTextExtents 

locally  /string  and  font  metrics  . XTextExtents  16 

locally  /get  the  width  in  pixels . XTextWidth 

locally  /get  the  width  in  pixels . XTextWidth  16 

location  XQueryPointer: . XQueryPointer 

location  within  the  pre-existing/ . XGetSublmage 

logical  function,  and  plane  mask/ . XSetState 

logical  operation  in  a  graphics/ . XSetFunction 

look  up  RGB  values  from  ASCII . XParseColor 

lower  a  window  in  the  stacking  - - -  XLowerWindow 

manager  Xrmlnitialize:  . Xrmlnitialize 

manager  /set  the  minimum . XSetStandardProperties 

manager  XStoreName:  assign  a  . XStoreName 

manager  hints  property  . . XGetWMHints 

manager  hints  property . XSetWMHints 

manager  (not  graphics  context) . XFindContext 

manager  properties . XSetWMProperties 

map  a  key  event  to  ASCII  string, . XLookupString 

map  a  window  . XMapWindow 

map  a  window  on  top  of  its  . XMapRaised 

map  all  subwindows  of  window . XMapSubwindows 

mapping  XChangeKeyboardMapping: ...  XChangeKeyboardMapping 

mapping  XGetPointerMapping: . XGetPointerMapping 

mapping  XSetPointerMapping: . XSetPointerMapping 

mapping  from  server  into  Xlib . XRefreshKeyboardMapping 

mapping  of  modifier  keys  (Shifty . XGetModifierMapping 

mapping  structure  /destroy  . . XFreeModifiermap 

mapping  structure ......................................  XNewModifiermap 

mask  XMaskEvent:  remove  .....................  XMaskEvent 

mask  and  window  /remove  the  next . XWindowEvent 
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the  next  event  that  matches 
both  passed  window  and  passed 
XSetPlaneMask:  set  the  plane 
/logical  function,  and  plane 
/information  structures  that 
XPeeklfEvent:  get  an  event 
XlfEvent:  wait  for  event 
/the  next  event  in  queue  that 
remove  the  next  event  that 
/remove  the  next  event  that 
/the  visual  information  that 
/remove  the  next  event  that 
passed/  /remove  the  next  event 
check  the  event  queue  for  a 
/return  the  next  event  in  queue 
function  XFree:  free  specified 
XFreeFontPath:  free  the 
XFreeFontNames:  free  the 
XFreeFontlnfo:  free  the 
XFreeExtensionList:  free 
XDestroyAssocTable:  free  the 
XDestroylmage:  deallocate 
XCreatelmage:  allocate 
Xperm alloc:  allocate 
database/  XrmMergeDatabases: 

/obtain  error 
the  server  for  string  and  font 
get  string  and  font 
/the  server  for  string  and  font 
string^  /get  string  and  font 
XSetStandardProperties:  set  the 
XSetArcMode:  set  the  arc 
/set  the  subwindow 
/change  the  close  down 
etc.)  /obtain  a  mapping  of 
/destroy  and  free  a  keyboard 
/create  a  keyboard 
/set  keycodes  to  be  used  as 
/get  events  from  pointer 
XMoveWindow: 
point  on  the/  XWarpPointer: 

X  Draw  A  res:  draw 
XFillArcs:  fill 
X  Draw  Lines:  draw 
XDrawSegments:  draw 
control/  XRemoveHosls:  remove 
control  list  XAddHosts:  add 
X  Draw  Points:  draw 
/draw  the  outlines  of 
XFillRectangles:  fill 
a  read-only  colorcell  from  color 
RGB  values  from  color 
a  read/write  colorcell  by  color 
/get  a  resource  value  using 
/get  a  resource  from 
database  using  a  quark  resource 
with  separate  resource 
atom  XGetAtomName:  get  a  string 


mask;  don’t  wait  /remove  ................. 

mask;  don’t  wait  /event  matching  ... 
mask  in  a  graphics  context  ............... 

mask  in  a  graphics  context  ............... 

match  the  specified  template  ............ 

matched  by  predicate  procedure/ . 

matched  in  predicate  procedure  ....... 

matches  event  type;  don’t  wait ......... 

matches  mask  XMaskEvent:  . — . — 

matches  mask;  don’t  wait . 

matches  the  desired  depth  and/  ........ 

matches  the  specified  mask  and / . 

matching  both  passed  window  and  .. 

matching  event  XChecklfEvent:  . 

matching  type  and  window  .............. 

memory  allocated  by  an  Xlib . 

memory  allocated  by  XGetFontPath 

memory  allocated  by  XlistFonts . 

memory  allocated  by/  ....................... 

memory  allocated  for  a  list  of/  _ _ ... 

memory  allocated  for  an/ . 

memory  associated  with  an  image  ... 

memory  for  an  Xlmage  structure . 

memory  never  to  be  freed  ................. 

merge  the  contents  of  one . 

messages  from  the  error  database  .... 

metrics  /query  . 

metrics  locally  XTextExtents: .......... 

metrics  of  a  16-bit  character/ . 

metrics  of  a  1 6-bit  character  ............. 

minimum  set  of  properties  for/  ......... 

mode  in  a  graphics  context . 

mode  in  a  graphics  context . 

mode  of  a  client . 

modifier  keys  (Shift,  Control, . 

modifier  mapping  structure  . 

modifier  mapping  structure  . 

modifiers  (Shift,  Control,  etc.)  . 

motion  history  buffer  ........................ 

move  a  window . 

move  the  pointer  to  another  ... 

multiple  arcs  . 

multiple  arcs  . 

multiple  connected  lines . 

multiple  disjoint  lines . 

multiple  hosts  from  the  access  . . 

multiple  hosts  to  the  access  ............. 

multiple  points . 

multiple  rectangles . 

multiple  rectangular  areas . 

name  XAllocNamedColor:  allocate 
name  /closest  hardware-supported  .. 
name  /set  RGB  values  of ... 
name  and  class  as  quarks  ... 
name  and  class  as  strings  ... 
name  and  string  value  Ao  a 
name  and  value  /specification  ......... 

name  for  a  property  given  its 


.........  XCheckMaskEvent 

_ _ XCheckWindowEvent 

.........  XSetPlaneMask 

....... ..  XSetState 

.........  XGetVisuallnfo 

.........  XPeeklfEvent 

.........  XlfEvent 

. XCheckTypedEvent 

- - XMaskEvent 

. XCheckMaskEvent 

. XMatchVisuallnfo 

.........  XWindowEvent 

.........  XCheckWindowEvent 

.........  XChecklfEvent 

.........  XCheckTypedWindowEvent 

. XFree 

. XFreeFontPath 

- XFreeFontNames 

.........  XFreeFontlnfo 

.........  XFreeExtensionList 

. XDestroyAssocTable 

. XDestroylmage 

. XCreatelmage 

.........  Xpermalloc 

. XrmMergeDatabases 

.........  XGetErrorDatabaseText 

- - XQueryTextExtents 

.........  XTextExtents 

. . XQueryTextExtents  16 

. XTextExtents  16 

. XSetStandardProperties 

. XSetArcMode 

. XSetSubwindowMode 

. XSetCloseDownMode 

. XGetModifierMapping 

. XFreeModifiermap 

.........  XNewModifiermap 

. XSetModifierMapping 

. XGetMotion  Events 

. XMoveWindow 

. XWarpPointer 

. XDrawArcs 

. XFillArcs 

. XDrawLines 

. XDrawSegments 

. XRemoveHosts 

_ XAddHosts 

. XDrawPoints 

. XDrawRectangles 

. XFillRectangles 

. XAllocNamedColor 

. XLookupColor 

. XStoreNamedColor 

_ XrmQGetResource 

. XrmGetResource 

_ .....  XrmQPutStringResource 

.........  XrmPutStringResource 

.........  XGetAtomName 
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/up  RGB  values  from  ASCII  color 
an  atom  for  a  given  property 
/convert  a  keysym 
manager  XStoreName:  assign  a 
window’s/  XSetlconName:  set  the 
XGetlconName:  get  the 
XDisplayName:  report  the  display 
XFetchName:  get  a  window’s 
a  list  of  the  available  font 
XlistFontsWithlnfo:  obtain  the 
X perm  alloc:  allocate  memory 
XCreateAssocTable:  create  a 
/copy  a  colormap  and  return  a 
XUniqueContext:  create  a 
XCreateRegion:  create  a 
XInsertModifiermapEntry:  add  a 
screen  with/  XCreateGC:  create  a 
XrmUniqueQuark:  allocate  a 
type  and  window  /return  the 
XCheckTypedEvent:  return  the 
XCheckWindowEvent:  remove  the 
XNextEvent:  get  the 
XMaskEvent:  remove  the 
XCheckMaskEvent:  remove  the 
XWindowEvent:  remove  the 
XSetErrorHandler:  set  a 
/allocate  read/write 
/allocate  read/write 
the  server  XNoOp:  send  a 
/hints  properly  of  a  window  in 
/hints  property  of  a  window  in 
a  colormap;  install  default  if 
XLoadFont:  load  a  font  if 
data  from  the  context  manager 
Ao  a  window  and  context  type 
/create  a  new  context  ID 
/of  a  window  in  normal  state 
/of  a  window  in  normal  state 
queue  XEventsQueued:  check  the 
/request  buffer  and  return  the 
current  state  of/  XQueryKeymap: 

code  XGetErrorText: 
access  to  this/  XListHosts: 
XTextPropertyToStringList: 
keyboard/  XGetKeyboardControl: 
keys/  XGetModifierMapping: 

an  image  XGetPixel: 
information  XWM Geometry: 
from  Xlib’s  GC /  XGetGCValues: 

table  XLookUpAssoc: 
error/  XGetErrorDatabaseText: 
of  colorcells  XQueryColors: 
property/  XGetWindowProperty: 

cursor,  tile,/  XQueryBestSize: 
window  XGetWindow Attributes: 
drawable  XGetGeometry: 
fill  tile  shape  XQueryBestTile: 
stipple/  XQueryBestStipple: 


name  or  translate  hexadecimal/  ........ 

name  string  X  Intern  Atom:  return  .... 

name  siring  to  a  keysym  ................... 

name  to  a  window  for  the  window  ... 
name  to  be  displayed  in  a  ................. 

name  to  be  displayed  in  an  icon  ....... 

name  (when  connection  to  a/ ............ 

name  (XA_WM_NAME  property) .. 

names  XListFonts:  return . 

names  and  information  about/ . 

never  to  be  freed  . . 

new  association  table  (X10)  ............. 

new  colormap  ID . 

new  context  ID  (not  graphics/ . 

new  empty  region . 

new  entry  to  an  XModifierKeymap/ 
new  graphics  context  for  a  given  ..... 

new  quark  . 

next  event  in  queue  matching . 

next  event  in  queue  that  matches/  .... 
next  event  matching  both  passed/  , 
next  event  of  any  type  or  window  , 

next  event  that  matches  mask . 

next  event  that  matches  mask;/  . 

next  event  that  matches  the/ . 

nonfatal  error  event  handler . . 

(nonsharcable)  color  planes . . 

(nonshared)  colorcells  . . . 

NoOp  to  exercise  connection  with 

normal  state  (not  zoomed  or/ . . 

normal  state  (not  zoomed  or/ . . 

not  already  installed  /uninstall . . 

not  already  loaded;  get  font  ID  ...... 

(not  graphics  context)  /get  . . 

(not  graphics  context) . . 

(not  graphics  context) . . 

(not  zoomed  or  iconified) . . 

(not  zoomed  or  iconified)  . . . 

number  of  events  in  the  event  . . 

number  of  pending  input  events  .... 

obtain  a  bit  vector  for  the  . . . 

obtain  a  description  of  error . . 

obtain  a  list  of  hosts  having . . 

obtain  a  list  of  strings  from  a / . . 

obtain  a  list  of  the  current . . 

obtain  a  mapping  of  modifier - 

obtain  a  single  pixel  value  from  .... 

obtain  a  window’s  geometry - 

obtain  components  of  a  given  GC 
obtain  data  from  an  association  ..... 

obtain  error  messages  from  the . 

obtain  RGB  values  for  an  array  .. 

obtain  the  atom  type  and . 

obtain  the  "best"  supported  ........ 

obtain  the  current  attributes  of  ... 
obtain  the  current  geometry  of  ... 

obtain  the  fastest  supported . 

obtain  the  fastest  supported - 


........  XParseColor 

........  XIn  tern  Atom 

. XStringToKeysym 

........  XStoreName 

........  XSetlconName 

........  XGetlconName 

- XDisplayName 

. XFetchName 

- XListFonts 

........  XlistFontsWithlnfo 

. Xpermalloc 

. XCreateAssocTable 

........  XCopyColormapAndFree 

........  XUniqueContext 

. . XCreateRegion 

. XInsertModifiermapEntry 

........  XCreateGC 

. XrmUniqueQuark 

. XCheckTypcdWindowEvent 

- XCheckTypedEvent 

. XCheckWindowEvent 

. XNextEvent 

. XMaskEvent 

. XCheckMaskEvent 

. XWindowEvent 

. XSetErrorHandler 

. XAllocColorPlanes 

........  XAllocColorCells 

. XNoOp 

. XGetNormalHints 

. XSetNonmalHints 

. XUninstallColormap 

. XLoadFont 

. XFindContext 

. XSaveContext 

. XUniqueContext 

. XGetNormalHints 

. XSetNormalHints 

. XEventsQueued 

. XPending 

. XQueryKeymap 

. XGetErrorText 

. XListHosts 

. XTextPropertyToStringList 

. XGetKeyboardControl 

. XGetModifierMapping 

. XGetPixel 

. XWMGeometry 

_ XGetGCValues 

. XLookUpAssoc 

. XGetErrorDatabaseText 

........  XQueryColors 

. XGetWindowProperty 

........  XQueryBestSize 

. XGetWindowAttributes 

........  XGetGeometry 

........  XQueryBestTile 

.... —  XQueryBestStipple 
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ID)  associated/  XGContextFromGC: 
about/  XListFontsWithlnfo: 
keycodes  for/  XDisplay  Key  codes: 

for  a  specified/  XQueryColor: 
formats  for/  XListPixmapFormats: 

Visual  XVisuallDFromVisual: 
that  matches/  XMatchVisuallnfo: 
structure/  XGetRGBColormaps: 
turn  the  screen  saver  on  or 
keys  XAutoRepeatOff:  turn 
two  regions  have  the  same  size, 
XOffsetRegion:  change 
an  8-bit  text  string,  foreground 
/set  the  bitwise  logical 
XGetDefault:  extract  an 
child  to  the  top  of  the  stacking 
to  the  bottom  of  the  stacking 
size,  border  width,  or  stacking 
lower  a  window  in  the  stacking 
to  the  top  of  the  stacking 
/circulate  the  slacking 
/change  the  stacking 
XSetClipOrigin:  set  the  clip 
/set  the  tile/stipple 
XDrawRectangle:  draw  an 
XDrawRectangles:  draw  the 
XGetSelectionOwner:  return  the 
XSetSelectionOwner:  set  the 
get  the  current  screen  saver 
grab  /change  the 
XSetScreenSaver:  set  the 
between  another  window  and  its 
return  a  list  of  children, 
create  a  subimage  from 
matching  both  passed  window  and 
/the  next  event  matching  both 
release  a  button  from  a 
XUngrabKey:  release  a  key  from  a 
get  the  current  font  search 
set  the  font  search 
graphics/  XSetDashes:  set  a 
buffer  and  return  the  number  of 
repaint/  /change  a  window  border 
window  /set  the  background 
XGetPixel:  obtain  a  single 
context  /set  the  background 
context  /set  the  foreground 
/add  a  constant  value  to  every 
XPutPixel:  set  a 
a  drawable  with  depth,  applying 
XTextWidthl6:  get  the  width  in 
XTextWidth:  gel  the  width  in 
XCreatePixmap:  create  a 
draw  an  image  on  a  window  or 
server  /obtain  the  supported 
XFreePixmap:  free  a 
XSetClipMask:  set  clip_mask 
data,  /create  a 


obtain  the  GContext  (resource 
obtain  the  names  and  information  .. 
obtain  the  range  of  legal  ................. 

obtain  the  RGB  values  and  flags  .... 

obtain  the  supported  pixmap  .......... 

obtain  the  visual  ID  from  a  . . 

obtain  the  visual  information . 

obtain  the  XStandardColormap ...... 

off  XForceScreenSaver: ................. 

off  the  keyboard  auto-repeat  ...... — 

offset,  and  shape  /determine  if ....... 

offset  of  a  region  ............................. 

only  XDrawString:  draw  ................ 

operation  in  a  graphics  context  ...... 

option  value  from  the  resource/  ..... 

order  /circulate  the  bottom  ............. 

order  /circulate  the  top  child  .......... 

order  /the  window  position,  ........... 

order  XLowerWindow: . 

order  /raise  a  window  ..................... 

order  of  children  up  or  down  .......... 

order  of  siblings . 

origin  in  a  graphics  context . 

origin  in  a  graphics  context . 

outline  of  a  rectangle . 

outlines  of  multiple  rectangles  ... — 

owner  of  a  selection  . 

owner  of  a  selection  . 

parameters  XGetScreenSaver: . 

parameters  of  an  active  pointer . 

parameters  of  the  screen  saver . 

parent  /insert  a  window . 

parent,  and  root  XQueryTree:  ........ 

part  of  an  image  XSublmage: . 

passed  mask;  don’t  wait  /event ...... 

passed  window  and  passed  mask;/ . 

passive  grab  XUngrabButton:  . 

passive  grab . . . 

path  XGetFontPath: . 

path  XSetFontPath:  . 

pattern  of  line  dashes  in  a  ............... 

pending  input  events  /request  ........ 

pixel  value  attribute  and  . 

pixel  value  attribute  of  a  . . 

pixel  value  from  an  image . 

pixel  value  in  a  graphics  . — ..... - 

pixel  value  in  a  graphics  . . 

pixel  value  in  an  image . 

pixel  value  in  an  image . 

pixel  values  /of  a  drawable  into  ..... 

pixels  of  a  16-bit  character/ . 

pixels  of  an  8-bit  character/ . 

pixmap  XPutlmage:  . . 

pixmap  formats  for  a  given  . . 

pixmap  ID . 

pixmap  in  a  graphics  context . 

pixmap  with  depth  from  bitmap  ..... 


....  XGContextFromGC 
....  XListFontsWithlnfo 
....  XDisplayKeycodes 
....  XQueryColor 
....  XListPixmapFormats 
....  XVisuallDFromVisual 
....  XMatchVisuallnfo 
....  XGetRGBColormaps 
....  XForceScreenSaver 
....  XAutoRepeatOff 
....  XEqualRegion 
....  XOffsetRegion 
....  XDrawString 
....  XSetFunction 
....  XGetDefault 

....  XCirculateSubwindowsDown 

....  XCirculateSubwindowsUp 

....  XConfigureWindow 

....  XLowerWindow 

....  XRaiseWindow 

....  XCirculateSubwindows 

....  XRestackWindows 

....  XSetClipOrigin 

....  XSetTSOrigin 

....  XDrawRectangle 

....  XDrawRectangles 

....  XGetSelectionOwner 

....  XSetSelectionOwner 

....  XGetScreenSaver 

....  XChangeActivePointerGrab 

....  XSetScreenSaver 

....  XReparentWindow 

....  XQueryTree 

....  XSublmage 

....  XCheckWindowEvent 

....  XCheckWindowEvent 

....  XUngrabButton 

....  XUngrabKey 

....  XGetFontPath 

....  XSetFontPath 

....  XSetDashes 

....  XPending 

....  XSetWindowBorder 

....  XSetWindowBackground 

....  XGetPixel 

....  XSetBackground 

....  XSetForeg  round 

....  XAddPixel 

....  XPutPixel 

....  XCopyPlane 

....XTextWidth  16 

....  XTextWidth 

....  XCreatePixmap 

....  XPutlmage 

....  XListPixmapFormats 

....  XFreePixmap 

....  XSetClipMask 

....  XCreatePixmapFromBitmapData 
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from  drawable  into/  XGetlmage: 
XSetPlaneMask:  set  the 
/logical  function,  and 
XCopyPlane:  copy  a  single 
read/write  (nonshareable)  color 
free  colormap  cells  or 
XDrawPoint:  draw  a 
XPointlnRegion:  determine  if  a 
/move  the  pointer  to  another 
XGrabPointer  grab  the 
XGrabButton:  grab  a 
XGetPointerMapping:  get  the 
XSetPointerMapping:  set  the 
/the  behavior  of  keyboard  and 
XUngrabPointer:  release  the 
the  parameters  of  an  active 
XQueryPointer:  get  the  current 
/get  events  from 
/change  the 
/get  the  current 
screen  XWarpPointer:  move  the 
draw  a  line  between  two 
XDrawPoints:  draw  multiple 
generate  a  region  from 
XFillPolygon:  fill  a 
list/  XDrawFilled:  draw  a  filled 
list  (from  X10)  XDraw:  draw  a 
XDrawText:  draw  8 -bit 
XDrawTextl6:  draw  16-bit 
window/  XParseGeometry:  generate 
/change  the  size  and 
stacking/  /change  the  window 
/colormap  entry  to  the  closest 
/colorcells  to  the  closest 
wait  for  event  matched  in 
/get  an  event  matched  by 
to  a  location  within  the 
/change  the  pointer 
a  list  of  the  current  keyboard 
get  the  current  pointer 
/change  the  keyboard 
XGetlconSizes:  get 
XrmQGetSearchResource:  search 
for  event  matched  in  predicate 
/an  event  matched  by  predicate 
for  all  events  and  errors  to  be 
display  /disconnect  a  client 
XOpen Display:  connect  a  client 
read  one  of  a  window’s  text 
set  one  of  a  window’s  text 
window’s  standard  window  manager 
/rotate  properties  in  the 
manager  /set  the  minimum  set  of 
XRotateWindowProperties:  route 
XDeleteProperty:  delete  a  window 
get  a  window’s  name  (X A_ WM_N AM E 
associated  with  the  specified 
get  the  sundard  colormap 


place  contents  of  a  recUngle _ _ _ _ XGetlmage 

plane  mask  in  a  graphics  context  _ _ ...  XSetPlaneMask 

plane  mask  in  a  graphics  context  - - XSetSute 

plane  of  a  drawable  into  a / ........................  XCopyPlane 

planes  /allocate  - - XAUocColorPlanes 

planes  XFreeColors: . XFreeColors 

point  ............^.......w^..............................„  XDrawPoint 

point  is  inside  a  region  _ _ _ _ _ _ XPointlnRegion 

point  on  the  screen  ....................................  XWarpPointer 

pointer - XGrabPointer 

pointer  button  - - XGrabButton 

pointer  button  mapping - XGetPointerMapping 

pointer  button  mapping  . . XSetPointerMapping 

pointer  events  when  these/  .......................  XAllowEvents 

pointer  from  an  active  grab  . XUngrabPointer 

pointer  grab  /change . XChangeActivePointerGrab 

pointer  location - - XQueryPointer 

pointer  motion  history  buffer  .... _ .........  XGetMotion  Events 

pointer  preferences - XChangePointerControl 

pointer  preferences  . . XGetPointerControl 

pointer  to  another  point  on  the  . . XWarpPointer 

points  XDrawIine:  . . XDrawLine 

points . XDrawPoints 

points  XPolygonRegion: - XPolygonRegion 

polygon . XFillPolygon 

polygon  or  curve  from  vertex . XDrawFilled 

polyline  or  curve  between  vertex . XDraw 

polytext  strings . . . XDrawText 

polytext  strings . XDrawTextl6 

position  and  size  from  standard  . XParseGeometry 

position  of  a  window . XMoveResizeWindow 

position,  size,  border  width,  or . XConfigure Window 

possible  hardware  color . XStoreColor 

possible  hardware  colors  . XStoreColors 

predicate  procedure  XlfEvent:  . XlfEvent 

predicate  procedure  without/ . XPeeklfEvent 

pre-existing  image  /in  drawable  . .  XGetSublmage 

preferences . XChangePointerControl 

preferences  /obuin  . XGetKeyboardControl 

preferences  XGetPointerControl: . XGetPointerControl 

preferences  such  as  key  click . XChangeKeyboardControl 

preferred  icon  sizes  . . XGetlconSizes 

prepared  list  for  a  given/ . XrmQGetSearchResource 

procedure  XlfEvent:  wait . XlfEvent 

procedure  without  removing  it / . XPeeklfEvent 

processed  by  the  server  /wait . XSync 

program  from  an  X  server  and  . XCloseDisplay 

program  to  an  X  server . XOpenDisplay 

properties  XGetTextProperty: . XGetTextProperty 

properties  XSetTextProperty:  ......... - XSetTextProperty 

properties  /set  a . XSetWMProperties 

properties  array . XRouteWindowProperties 

properties  for  the  window . XSetSundardProperties 

properties  in  the  properties/  . . XRouteWindowProperties 

property . . XDeleteProperty 

property)  XFetchName:  . . XFetchName 

property  /structure  . . XGetRGBColormaps 

property  XGetSundardColormap:  . XGetSundardColormap 
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read  the  window  manager  hints 
read  a  window’s  X A_ WM_ICON_N AM E 
read  a  window’s  XA_WM_NAME 
a  window’s  XA_WM_NORMAL_HINTS 
read  a  window’s  X A_ WM_S IZE_HINTS 
the  value  of  the  XA_WM_ICON_SIZE 
change  the  standard  colormap 
set  a  window’s  WM_CLIENT_MACHINE 
a  window’s  WM_COLORMAP_WINDOWS 
set  a  window  manager  hints 
set  a  window’s  XA_WM_ICON_NAME 
set  a  window’s  XA_WM_NAME 
a  window’s  XA_WM_NORMAL_HINTS 
set  a  window’s  WM_PROTOCOLS 
set  a  window’s  WM_SIZE_HINTS 
XChangeProperty:  change  a 
/set  the  X  A_WM_TRAN  S  IENT_FOR 
/obtain  the  atom  type  and 
/get  a  string  name  for  a 
XGetFontProperty:  get  a  font 
XListProperties:  get  the 
/return  an  atom  for  a  given 
/get  the  XA_WM_CLASS 
/get  the  X  A_WM_TRAN  S  IENT_FOR 
/set  the  XA_WM_CLASS 
state  (not /  /get  the  size  hints 
state  (not/  /set  the  size  hints 
/read  the  size  hints 
/set  the  size  hints 
XGetSizeHints:  read  any 
/set  the  value  of  any 
queue  XPutBackEvent: 
convert  a  string  to  a 
XrmUniqueQuaik:  allocate  a  new 
string  to  a  binding  list  and  a 
/convert  a  key  string  to  a 
value  Ao  a  database  using  a 
XrmQuarkToString:  convert  a 
value  using  name  and  class  as 
into  a  database  using 
font  metrics  XQueryTextExtents : 
font/  XQueryTextExtents  16: 
number  of  events  in  the  event 
without  removing  it  from  the 
without  removing  it  from  the 
push  an  event  back  on  the  input 
XChecklfEvent:  check  the  event 
/return  the  next  event  in 
don’t/  /return  the  next  event  in 
the  request  buffer  (display  all 
stacking  order  XRaiseWindow: 
X  Display  Key  codes:  obtain  the 
XReadBitmapFile: 
property  XGetWMIconName: 
property  XGetWMName: 
XGetWMNormalHints : 
property  XGetWMSizeHints: 
XA_SIZE_HINTS  XGetSizeHints: 


property  XGelWMHints:  . XGetWMHints 

property  XGetWMIconName: .................  XGetWMIconName 

property  XGetWMName:  .......................  XGetWMName 

property  /read . XGetWMNormalHints 

property  XGetWMSizeHints:  ..................  XGetWMSizeHints 

property  XSetlconSizes:  set . . XSetlconSizes 

property  XSetStandardColormap:  ...........  XSetStandardColormap 

property  XSetWMClientMachine:  ..........  XSetWMClientMachine 

property  /set  ..............................................  XSetWMColormapWindows 

property  XSetWMHints: . XSetWMHints 

property  XSetWMIconName:  . XSetWMIconName 

property.  XSetWMName:  ........................  XSetWMName 

property  XSetWMNormalHints:  set . XSetWMNormalHints 

property  XSetWMProtocols: - XSelWMProtocols 

property  XSetWMSizeHints: ...................  XSetWMSizeHints 

property  associated  with  a/  .......................  XChangeProperty 

property  for  a  window  . XSetTransientForHint 

property  format  for  a  window  . . XGetWindowProperty 

property  given  its  atom  ................ - - —  XGetAtomName 

property  given  its  atom . XGetFontProperty 

property  list  for  a  window  ........................  XListProperties 

property  name  string  . . XIntcm Atom 

property  of  a  window . XGeiClassHint 

property  of  a  window . XGetTransientForHint 

property  of  a  window  . . XSetClassHint 

property  of  a  window  in  normal . — ..........  XGetNormalHints 

property  of  a  window  in  normal . XSetNormalHints 

property  of  a  zoomed  window  . . XGelZoomHints 

property  of  a  zoomed  window  . XSetZoomHints 

property  of  type  XA_SIZE_HENTS . XGetSizeHints 

property  of  type  XA_SEE_HENTS . XSetSizellints 

push  an  event  back  on  the  input . XPutBackEvent 

quark  XrmStringToQuark: .......................  XrmSlringToQuark 

quark  . XrmllniqueQuark 

quark  list  /convert  a  key . XrmStringToBindingQuarkList 

quark  list . XrmStringToQuark  List 

quark  resource  name  and  string  . XrmQPutStringResource 

quark  to  a  string . XrmQuarkToString 

quarks  /get  a  resource  . . XrmQGetResource 

quarks  /a  resource  specification  . XrmQPutResource 

query  the  server  for  string  and  . XQueryTextExtents 

query  the  server  for  string  and  . XQueryTextExtents  16 

queue  XEventsQueued:  check  the . XEventsQueued 

queue  XPeekEvent:  get  an  event .............  XPeekEvent 

queue  /by  predicate  procedure  .................  XPeeklfEvent 

queue  XPutBackEvent: . XPutBackEvent 

queue  for  a  matching  event . XChecklfEvent 

queue  matching  type  and  window  . XCheckTypedWindowEvent 

queue  that  matches  event  type;  . XCheckTyped  Event 

queued  requests)  XFlush:  flush  . . XFlush 

raise  a  window  to  the  top  of  the  . XRaiseWindow 

range  of  legal  keycodes  for  a/ . XDisplayKeycodes 

read  a  bitmap  from  disk . XReadBitmapFile 

read  a  window’s  XA_WM_ICON_NAME  XGetWMIconName 

read  a  window’s  XA.WM.NAME _ XGetWMName 

read  a  window’s/  . . XGetWMNormalHints 

read  a  window’s  XA_WM_SEE_HINTS  XGetWMSizeHints 
read  any  property  of  type  . . XGetSizeHints 
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server/  XRefreshKeyboardMapping:  read  keycode-keysym  mapping  from  ......  XRefreshKeyboardMapping 

properties  XGetTextProperty:  read  one  of  a  window’s  text  .....................  XGetTextProperty 

a  zoomed  window  XGetZoom Hints:  read  the  size  hints  property  of . XGetZoom Hints 

property  XGetWMHints:  read  the  window  manager  hints  ...............  XGetWMHints 

X All ocNamed Color:  allocate  a  read-only  colorcell  from  color/  . . X All ocNamed Color 

closest/  XAllocColor:  allocate  a  read-only  colormap  cell  with _ XAllocColor 

name  /set  RGB  values  of  a  read/write  colorcell  by  color . XStoreNamedColor 

/set  or  change  the  RGB  values  of  read/write  colorcells  to  the/ . XStoreColors 

/or  change  the  RGB  values  of  a  read/write  colormap  entry  to  the/ _ XStoreColor 

XAllocColorPlanes:  allocate  read/write  (non  shareable)  color/ . XAllocColorPlanes 

XAllocColoiCells:  allocate  read/write  (nonshared)/  .......... _ ...............  XAllocColorCells 

client  XRebindKeysym:  rebind  a  keysym  to  a  string  for _ _ _ XRebindKeysym 

that  a  top-level  window  be  reconfigured  /request _ _ ............. _ XReconfigureWMWindow 

draw  an  arc  fitting  inside  a  rectangle  XDrawArc:  ...............................  XDrawArc 

draw  an  outline  of  a  rectangle  XDrawRectangle:  ............. _ XDrawRectangle 

XChpBox:  generate  the  smallest  rectangle  enclosing  a  region  .....................  XClipBox 

XGetlmage:  place  contents  of  a  rectangle  from  drawable  into  an/ . XGetlmage 

location/  XGetSublmage:  copy  a  rectangle  in  drawable  to  a  .........................  XGetSublmage 

XRectlnRegion:  determine  if  a  rectangle  resides  in  a  region . XRectlnRegion 

XUnionRectWithRegion:  add  a  rectangle  to  a  region . XUnionRectWithRegion 

draw  the  outlines  of  multiple  rectangles  XDrawRectangles: . XDrawRectangles 

a  graphics  context  to  a  list  of  rectangles  /change  clip_mask  in . XSetClipRectangles 

XFillRectangle:  fill  a  rectangular  area . . ...........  XFillRectangle 

XClearArea:  clear  a  rectangular  area  in  a  window  . XClearArea 

XFillRectangles:  fill  multiple  rectangular  areas  . XFillRectangles 

region  XShrinkRegion:  reduce  or  expand  the  size  of  a . . . . XShrinkRegion 

smallest  rectangle  enclosing  a  region  XClipBox:  generate  the . XClipBox 

create  a  new  empty  region  XCreateRegion:  . . XCreateRegion 

storage  associated  with  a  region  /deallocate  . XDestroyRegion 

change  offset  of  a  region  XOffsetRegion: . XOffsetRegion 

determine  if  a  point  is  inside  a  region  XPointlnRegion: . XPointlnRegion 

if  a  rectangle  resides  in  a  region  XRectlnRegion:  determine  . XRectlnRegion 

context  to  the  specified  region  /of  the  graphics . .. . XSetRegion 

reduce  or  expand  the  size  of  a  region  XShrinkRegion:  .. . XShrinkRegion 

add  a  rectangle  to  a  region  XUnionRectWithRegion: . XUnionRectWithRegion 

XSubtractRegion:  subtract  one  region  from  another  .. . XSubtractRegion 

XPolygonRegion:  generate  a  region  from  points . XPolygonRegion 

XEmptyRegion:  determine  if  a  region  is  empty . XEmptyRegion 

compute  the  intersection  of  two  regions  XIntersectRegion:  . XIntersectRegion 

compute  the  union  of  two  regions  XUnionRegion:  . XUnionRegion 

union  and  intersection  of  two  regions  /difference  between  the . XXorRegion 

XEqualRegion:  determine  if  two  regions  have  the  same  size,/  . . XEqualRegion 

grab  XUngrabButton:  release  a  button  from  a  passive  . XUngrabButton 

XFreeCursor:  release  a  cursor . XFreeCursor 

grab  XUngrabKey:  release  a  key  from  a  passive  . . XUngrabKey 

active  grab  XUngrabKeyboard:  release  the  keyboard  from  an  . XUngrabKeyboard 

active  grab  XUngrabPointer:  release  the  pointer  from  an  . XUngrabPointer 

XUngrabServer:  release  the  server  from  grab  . . XUngrabServer 

/destroy  a  client  or  its  remaining  resources  ......... . . . XKillClient 

control  list  XRemoveHost:  remove  a  host  from  the  access  . XRemoveHost 

client’s/  XChangeSaveSet:  add  or  remove  a  subwindow  from  the  .................  XChangeSaveSet 

client’s/  XRemoveFromSaveSet:  remove  a  window  from  the . XRemoveFromSaveSet 

access  control/  XRemoveHosts:  remove  multiple  hosts  from  the  ................  XRemoveHosts 

both  passed/  XCheckWindowEvent:  remove  the  next  event  matching  . XCheckWindowEvent 

matches  mask  XMaskEvent:  remove  the  next  event  that .............. - -  XMaskEvent 

matches  mask;/  XCheckMaskEvent:  remove  the  next  event  that . XCheckMaskEvent 

matches  the/  XWindowEvent:  remove  the  next  event  that ............ - ...  XWindowEvent 

XPeekEvent:  get  an  event  without  removing  it  from  the  queue  ....... — .........  XPeekEvent 
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/by  predicate  procedure  without 
border  pixel  value  attribute  and 
window  border  tile  attribute  and 
connection  to  a/  XDisplayName: 
number  of/  XPending:  flush  the 
events  and /  XSync:  flush  the 
queued/  XFlush:  flush  the 
be  iconified  Xlconify Window: 
be/  XReconfigureWMWindow: 
be  withdrawn  XWithd  raw  Window: 
list  to  allow  or  deny  connection 
buffer  (display  all  queued 
XResetScreenSaver: 
/determine  if  a  rectangle 
search  prepared  list  for  a  given 
extract  an  option  value  from  the 
XrmDestroyDatabase:  destroy  a 
a  resource  specification  to  a 
a  resource  specification  into  a 
line/  XrmParseCommand:  load  a 
XrmPutFileDatabase:  store  a 
strings  XrmGetResource:  get  a 
the/  /obtain  the  GContext 
Xrmlnitialize:  initialize  the 
Ao  a  database  using  a  quark 
/specification  with  separate 
XrmQPutResource:  store  a 
XrmPutResource:  store  a 
XrmQPutStringResource:  add  a 
XrmPutLineResource:  add  a 
XrmPutStringResource:  add  a 
class  as/  XrmQGetResource:  get  a 
a  client  or  its  remaining 
and  pointer  events  when  these 
XrmGetFileDatabase: 
to  X  supported/  XListExtensions: 
parent,  and  root  XQueryTree: 
XrmQGetSearchUst: 
font  names  XListFonts: 
/copy  a  colormap  and 
property  name/  XIn  tern  Atom: 

XFetchBuffer: 

XFetchBytes: 
loaded  font  XQueryFont: 
XGetKeyboardMapping: 
focus  window  XGetlnputFocus: 
XCheckTypedWindowEvent: 
that  matches/  XCheckTypedEvent: 
/flush  the  request  buffer  and 
XGetSelectionOwner: 
XLookupColor:  get  database 
XQueryColor:  obtain  the 
colorcells  XQueryColors:  obtain 
or/  XParseColor:  look  up 
/and  closest  hardware-supported 
colorcell/  XStoreNamedColor  set 
XStoreColor:  set  or  change  the 
XStoreColors:  set  or  change  the 


removing  it  from  the  queue  ......................  XPeeklfEvent 

repaint  the  border  /a  window  ...................  XSetWindowBorder 

repaint  the  border  /change  a  .....................  XSelWindowBorderPixmap 

report  the  display  name  (when  .................  XDisplayName 

request  buffer  and  return  the  .... _ XPending 

request  buffer  and  wait  for  all . XSync 

request  buffer  (display  all  .........................  XFlush 

request  that  a  top-level  window  ...............  XlconifyWindow 

request  that  a  top-level  window  - ........  XReconfigureWMWindow 

request  that  a  top-level  window . — ...  XWithdrawWindow 

requests  /use  access  control  ............... —  XEnableAccessControl 

requests)  /flush  the  request  ..... — .............  XFlush 

reset  the  screen  saver  ........ - - - XResetScreenSaver 

resides  in  a  region  . XRectlnRegion 

resource  XrmQGetSearchResource:  .......  XrmQGetSearchResource 

resource  database  XGetDefaull:  . . XGetDefault 

resource  database . .  XrmDestroyDatabase 

resource  database  /add  .............................  XrmPutLineResource 

resource  database  /store  ...........................  XrmPutResource 

resource  database  from  command  ...........  XrmParseCommand 

resource  database  in  a  file . XrmPutFileDatabase 

resource  from  name  and  class  as  ..............  XrmGetResource 

(resource  ID)  associated  with - ..........  XGContextFromGC 

resource  manager  ......................................  Xrmlnitialize 

resource  name  and  string  value . XrmQPutStringResource 

resource  name  and  value  ......... — ..... — ....  XrmPutStringResource 

resource  specification  into  a/  ....................  XrmQPutResource 

resource  specification  into  a/ . XrmPutResource 

resource  specification  to  a / . XrmQPutStringResource 

resource  specification  to  a/  .......................  XrmPutLineResource 

resource  specification  with/ . XrmPutStringResource 

resource  value  using  name  and  . XrmQGetResource 

resources  XKillClient:  destroy  - XKillClient 

resources  are  grabbed  /keyboard . XAllowEvents 

retrieve  a  database  from  a  file  . XrmGetFileDatabase 

return  a  list  of  all  extensions . XListExtensions 

return  a  list  of  children . XQueryTree 

return  a  list  of  database  levels  . XrmQGetSearchLisi 

return  a  list  of  the  available - ..............  XListFonts 

return  a  new  colormap  ID  . . XCopyColormapAndFree 

return  an  atom  for  a  given  . XIntemAtom 

return  data  from  a  cut  buffer . XFetchBuffer 

return  data  from  cut  buffer  0  ....................  XFetchBytes 

return  information  about  a . XQueryFont 

return  symbols  for  keycodes  . . XGetKeyboardMapping 

return  the  current  keyboard  . XGetlnputFocus 

return  the  next  event  in  queue/  . XCheckTypedWindowEvent 

return  the  next  event  in  queue . XCheckTypedEvent 

return  the  number  of  pending/ . XPending 

return  the  owner  of  a  selection . XGetSelectionOwner 

RGB  values  and  closest/  ...........................  XLookupColor 

RGB  values  and  flags  for  a / ......................  XQueryColor 

RGB  values  for  an  array  of .......................  XQueryColors 

RGB  values  from  ASCII  color  name  .......  XParseColor 

RGB  values  from  color  name  ...................  XLookupColor 

RGB  values  of  a  read/write  ......................  XStoreNamedColor 

RGB  values  of  a  read/write/  .....................  XStoreColor 

RGB  values  of  read/wrile/ . .............  XStoreColors 
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XBell: 

a  list  of  children,  parent,  and 
XRotateWindowProperties : 

XRotateBuffers: 
XSetFillRule:  set  the  fill 
Af  two  regions  have  the 
to  a  window  and/  XSaveContext: 

reset  the  screen 
set  the  parameters  of  the  screen 
/turn  the  screen 
/get  the  current  screen 
add  a  window  to  the  client’s 
a  subwindow  from  the  client’s 
a  window  from  the  client’s 
the  depths  available  on  a  given 
pointer  to  another  point  on  the 
XActivateScreenSaver:  activate 
XResetScreenSaver:  reset  the 
set  the  parameters  of  the 
XForceScreenSaver:  turn  the 
XGetScreenSaver:  get  the  current 
.  new  graphics  context  for  a  given 
get  the  current  font 
XSetFontPath:  set  the  font 
resource  XrmQGetSearchResource: 
sent  to  a  window  XSelectlnput: 

use  the  value  of  a 
return  the  owner  of  a 
set  the  owner  of  a 
connection  with  the/  XNoOp: 

XSend  Event: 
select  the  event  types  to  be 
/a  resource  specification  with 
range  of  legal  keycodes  for  a 
XGrabServer:  grab  the 
to  X  supported  by  Xlib  and  the 
pixmap  formats  for  a  given 
to  exercise  connection  with  the 
connect  a  client  program  to  an  X 
errors  to  be  processed  by  the 
a  client  program  from  an  X 
XQueryTextExtents:  query  the 
XQueryTextExtentsl6:  query  the 
XUngrabServer:  release  the 
/read  keycode-keysym  mapping  from 
Xlib/  XSetAfterFunction: 
handler  XSetErrorHandler: 
a  graphics  context  XSetDashes: 

XPutPixel: 
property  XSetWMHints: 
manager/  XSetWMProperties: 
property  XSetWMClientMachine: 
XSetWMColormapWindows : 
property  XSetWMProtocols : 
property  XSetWMSizeHints : 
property  XSetWMIconName: 
property.  XSetWMName: 
XSetWMNormalHints  : 


ring  the  bell  (Control  G) _ XBell 

root  XQueryTree:  return . XQueryTree 

rotate  properties  in  the/ . XRotateWindowProperties 

rotate  the  cut  buffers  . . . XRotateBuffers 

rule  in  a  graphics  context _ _ ..... _ XSetFillRule 

same  size,  offset,  and  shape  ......................  XEqualRegion 

save  a  data  value  corresponding  . XSaveContext 

saver  XResetScreenSaver: _ _ _ XResetScreenSaver 

saver  XSetScreenSaver: . XSetScreenSaver 

saver  on  or  off  . XForceScreenSaver 

saver  parameters - XGetScreenSaver 

save-set  XAddToSaveSet:  . XAddToSaveSet 

save-set  /add  or  remove  - ..........  XChangeSaveSet 

save-set  /remove  .......................................  XRemoveFromSaveSet 

screen  XListDepths:  determine  . XListDepths 

screen  XWarpPointer:  move  the  . . XWarpPointer 

screen  blanking  . . XActivateScreenSaver 

screen  saver  ............... - - XResetScreenSaver 

screen  saver  XSetScreenSaver:  ...............  XSetScreenSaver 

screen  saver  on  or  off . XForceScreenSaver 

screen  saver  parameters _ _ _ _  XGetScreenSaver 

screen  with  the  depth  of  the/  /a . XCreateGC 

search  path  XGetFontPath: . XGetFontPath 

search  path . . XSetFontPath 

search  prepared  list  for  a  given  . XrmQGetSearchResource 

select  the  event  types  to  be  .......................  XSelectlnput 

selection  XConvertSelection:  . XConvertSelection 

selection  XGetSelectionOwner:  . XGetSelectionOwner 

selection  XSetSelectionOwner: . XSetSelectionOwner 

send  a  NoOp  to  exercise . XNoOp 

send  an  event . XSend  Event 

sent  to  a  window  XSelectlnput: . XSelectlnput 

separate  resource  name  and  value . XrmPutStringResource 

server  /obtain  the  . XDisplayKeycodes 

server . — .. . XGrabServer 

server  /a  list  of  all  extensions . XListExtensions 

server  /obtain  the  supported . XListPixmapFormats 

server  XNoOp:  send  a  NoOp . XNoOp 

server  XOpenDisplay: . XOpenDisplay 

server  /wait  for  all  events  and . XSync 

server  and  display  /disconnect . XCloseDisplay 

server  for  string  and  font/ . XQueryTextExtents 

server  for  siring  and  font/ . XQueryTextExtents  16 

server  from  grab  . . XUngrabServer 

server  into  Xlib . XRefreshKeyboardMapping 

set  a  function  called  after  all . XSetAfterFunction 

set  a  nonfatal  error  event  . XSetErrorHandler 

set  a  pattern  of  line  dashes  in . XSetDashes 

set  a  pixel  value  in  an  image  - .........  XPutPixel 

set  a  window  manager  hints  .... - XSetWMHints 

set  a  window’s  standard  window  .............  XSetWMProperties 

set  a  window’s  WM_CLIENT_MACHENE  XSetWMClientMachine 

set  a  window’s/ . . XSetWMColormapWindows 

set  a  window’s  WM_PROTOCOLS  ........  XSetWMProtocols 

set  a  window’s  WM _S IZE_HINTS  . . XSetWMSizeHints 

set  a  window’s  XA_WM_ICON_NAME  XSetWMIconName 

set  a  window's  XA_WM_NAME  — . XSetWMName 

set  a  window’s/ . XSetWMNormalHints 
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structure  XSetRGBColormaps: 

create  a  window  and 
context  to  the/  XSetRegion: 
graphics  context  XSetClipMask: 
modifiers/  XSetModifierMapping: 
manager  /set  the  minimum 
properties  XSetTextProperty: 
a  read/write/  XStoreColor: 
read/write/  XStoreColors: 
colorcell  by/  XStoreNamedColor: 

context  XSetArcMode: 
attribute/  XSetWindowBackground: 
in  a  graphics/  XSetBackground: 
operation  in  a/  XSetFunction: 
graphics/  XSetClipOrigin: 
window  XSetWindowColormap: 
graphics  context  XSetFont: 
context  XSetFillRule: 
context  XSetFillStyle: 
context  XSetTile: 

XSetFontPath: 
logical  function  J  XSetState: 
in  a  graphics/  XSetForeground: 
XSetGraphicsExposures: 

XSetlnputFocus: 
in  a /  XSetLine Attributes: 
XSetStandardProperties : 
a  window’s  icon  XSetlconName: 

XSetSelectionOwner: 
saver  XSetScreenSaver: 
context  XSetPlaneMask: 
XSetPointerMapping: 
window  in/  XSetNormalHints: 
zoomed  window  XSetZoom Hints: 
XStringListToTextProperty : 
context  XSetStipple: 
graphics/  XSetSubwindowMode: 
graphics  context  XSelTSOrigin: 

type/  XSetSizeHints: 

X A_WM_ICON_SIZE/  XSetlconSizes: 

a  window  XSetClassHint: 
(command  line/  XSetCommand: 
property /  XSctTransientForHint: 
XChangeWindow  Attributes : 
have  the  same  size,  offset,  and 
the  fastest  supported  stipple 
the  fastest  supported  fill  tile 
a  mapping  of  modifier  keys 
keycodes  to  be  used  as  modifiers 
map  a  window  on  top  of  its 
change  the  stacking  order  of 
XGetPixel:  obtain  a 
a  drawable/  XCopyPlane:  copy  a 
cursor,  tile,  or  stipple 
XResizeWindow:  change  a  window’s 
XMoveResizeWindow:  change  the 
/change  the  window  position, 
geometry/  /generate  position  and 


set  an  XStandardColormap  — .......... — ....  XSetRGBColormaps 

set  attributes  XCreateWindow:  ................  XCreateWindow 

set  clip_mask  of  the  graphics  - - XSetRegion 

set  clip_mask  pixmap  in  a  . XSetClipMask 

set  keycodes  to  be  used  as  ........................  XSetModifierMapping 

set  of  properties  for  the  window  — - XSetStandardProperties 

set  one  of  a  window’s  text  ........................  XSetTextProperty 

set  or  change  the  RGB  values  of  .. — .......  XStoreColor 

set  or  change  the  RGB  values  of  ..............  XStoreColors 

set  RGB  values  of  a  read/write  ....... — . XStoreNamedColor 

set  the  arc  mode  in  a  graphics  .......... — ....  XSetArcMode 

set  the  background  pixel  value  .. — .........  XSetWindowBackground 

set  the  background  pixel  value . XSetBackground 

set  the  bitwise  logical ................................  XSetFunction 

set  the  clip  origin  in  a  .................. - XSetClipOrigin 

set  the  colormap  attribute  for  a  . . XSetWindowColormap 

set  the  current  font  in  a  . . XSetFont 

set  the  fill  rule  in  a  graphics . XSetFillRule 

set  the  fill  style  in  a  graphics  . XSetFillStyle 

set  the  fill  tile  in  a  graphics . XSetTile 

set  the  font  search  path  .............................  XSetFontPath 

set  the  foreground,  background,  . XSetState 

set  the  foreground  pixel  value . XSetForeground 

set  the  graphics_exposures/ . XSetGraphicsExposures 

set  the  keyboard  focus  window - -  XSetlnputFocus 

set  the  line  drawing  components . XSetlineAttributes 

set  the  minimum  set  of/ . XSetStandardProperties 

set  the  name  to  be  displayed  in  . XSetlconName 

set  the  owner  of  a  selection  . . XSetSelectionOwner 

set  the  parameters  of  the  screen  . XSetScreenSaver 

set  the  plane  mask  in  a  graphics . XSetPlaneMask 

set  the  pointer  button  mapping . XSetPointerMapping 

set  the  size  hints  property  of  a . XSetNormalHints 

set  the  size  hints  property  of  a . XSetZoomHints 

set  the  specified  list  of/ . XStringListToTextProperty 

set  the  stipple  in  a  graphics . XSetStipple 

set  the  subwindow  mode  in  a . XSetSubwindowMode 

set  the  tile/stipple  origin  in  a . XSelTSOrigin 

set  the  value  of  any  property  of . XSetSizeHints 

set  the  value  of  the  . XSetlconSizes 

set  the  X  A_WM_CLASS  property  of ......  XSetClassHint 

set  the  XA_WM_COMMAND  atom . XSetCommand 

set  the  XA_WM_TRANSIENT_FOR  .....  XSetTransientForHint 

set  window  attributes  . XChangeWindowAttributes 

shape  /determine  if  two  regions  ...............  XEqualRegion 

shape  XQueryBestStipple:  obtain  . XQueryBestStipple 

shape  XQueryBestTile:  obtain . XQueryBestTile 

(Shift,  Control,  etc.)  /obtain  .....................  XGetModifierMapping 

(Shift,  Control,  etc.)  /set . XSetModifierMapping 

siblings  XMapRaised: . XMapRaiscd 

siblings  XRestack Windows: . XRestack Windows 

single  pixel  value  from  an  image . XGetPixel 

single  plane  of  a  drawable  into ........ — ...  XCopyPlane 

size  /the  "best"  supported . XQuery BestS  ize 

size  .................................„..MM.««.M...M. — ..XResizeWindow 

size  and  position  of  a  window  — ............  XMoveResizeWindow 

size,  border  width,  or  stacking/ . XConfigureWindow 

size  from  standard  window  .......................  XParseGeometry 
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in/  XGetNormalHints:  get  the 
in/  XSetNormalHints:  set  the 
window  XGetZoomHints:  read  the 
window  XSetZoomHints:  set  the 
reduce  or  expand  the 
/if  two  regions  have  the  same 
get  preferred  icon 
get  the  closest  supported  cursor 
region  XClipBox:  generate  the 
using  quarks  /store  a  resource 
XrmPutResource:  store  a  resource 
using  a  quark/  /add  a  resource 
database  /add  a  resource 
resource  name/  /add  a  resource 
the  RGB  values  and  flags  for  a 
screen  with  the  depth  of  the 
/ID)  associated  with  the 
XTextProperty  structure  /set  the 
/the  next  event  that  matches  the 
Xlib  function  XFree:  free 
/structure  associated  with  the 
of  the  graphics  context  to  the 
data  associated  with  the 
structures  that  match  the 
/obtain  a  list  of  strings  from  a 
bottom  child  to  the  top  of  the 
top  child  to  the  bottom  of  the 
position,  size,  border  width,  or 
lower  a  window  in  the 
raise  a  window  to  the  top  of  the 
down  /circulate  the 
XRestack Windows:  change  the 
XGetStandardColormap:  get  the 
XSetStandardColormap:  change  the 
/create  a  cursor  from  the 
/generate  position  and  size  from 
XSetWMProperties :  set  a  window’s 
/property  of  a  window  in  normal 
/property  of  a  window  in  normal 
a  bit  vector  for  the  current 
XSetS tipple:  set  the 
/obtain  the  fastest  supported 
supported  cursor,  tile,  or 
X  Destroy  Region:  deallocate 
/unload  a  font  and  free 
file  XrmPutFileDatabase: 
into  a/  XrmQPutResource: 
into  a  resource/  XrmPutResource: 

XStoreBuffer: 

XSloreBytes: 
atom  for  a  given  property  name 
convert  a  keysym  symbol  to  a 
from  standard  window  geometry 
metrics  of  a  16-bit  character 
create  a  database  from  a 
convert  a  quark  to  a 
/geometry  given  user  geometry 
/query  the  server  for 


size  hints  property  of  a  window  ... 
size  hints  property  of  a  window  ... 
size  hints  property  of  a  zoomed  ... 
size  hints  property  of  a  zoomed  ... 
size  of  a  region  XShrinkRegion:  . 

size,  offset,  and  shape  ..... _ ..... 

sizes  XGetlconSizes: . 

sizes  XQueryBestCursor: . . 

smallest  rectangle  enclosing  a . 

specification  into  a  database  ......... 

specification  into  a  resource/  ........ 

specification  to  a  database . 

specification  to  a  resource  ............ 

specification  with  separate  ........... 

specified  colorcell  /obtain  ............ 

specified  drawable  /for  a  given  .... 

specified  graphics  context  ............ 

specified  list  of  strings  to  an . 

specified  mask  and  window  ......... 

specified  memory  allocated  by  an 
specified  property . 


specified  region  /set  clip_mask  ... 
specified  string  list  An -memory  ... 
specified  template  /information  ... 

specified  XTextProperty/ . 

stacking  order  /circulate  the . 

stacking  order  /circulate  the . 

stacking  order  /the  window  .......... 

stacking  order  XLowerWindow:  . 
stacking  order  XRaiseWindow: ... 
stacking  order  of  children  up  or  ... 

stacking  order  of  siblings . 

standard  colormap  property . 

standard  colormap  property . 

standard  cursor  font  . 


standard  window  geometry  strin 

standard  window  manager/ . 

state  (not  zoomed  or  iconified)  . 
state  (not  zoomed  or  iconified)  . 
state  of  the  keyboard  /obtain  ..... 

stipple  in  a  graphics  context . 

stipple  shape  . 


stipple  size  /the  "best"  ................ 

storage  associated  with  a  region  . 

storage  for  the  font  structure  . 

store  a  resource  database  in  a  ...... 

store  a  resource  specification  . . 

store  a  resource  specification  ...... 

store  data  in  a  cut  buffer  - - ...... 

store  data  in  cut  buffer  0 . 

string  XIntemAtom:  return  an  .... 

string  XKeysymToString:  ........... 

string  /position  and  size 

string  /for  string  and  font  . . 

string  XrmGetStringDatabase:  ... 

string  XrmQuarkToString: . 

string  and  default  geometry  ......... 

string  and  font  metrics  .. . 


..  XGetNormalHints 

..  XSetNormalHints 

...  XGetZoomHints 

..  XSetZoomHints 

..  XShrinkRegion 

...  XEqualRegion 

...  XGetlconSizes 

..  XQueryBestCursor 

..  XClipBox 

...  XrmQPutResource 

...  XrmPutResource 

...  XrmQPutStringResource 

...  XrmPutLineResource 

...  XrmPutStringResource 

...  XQueryColor 

...  XCreateGC 

...  XGContextFromGC 

..  XStringListToTextProperty 

..  XWindowEvent 

..XFree 

..  XGetRGBColormaps 
..  XSetRegion 
..  XFreeStringList 
..  XGetVisuallnfo 
..  XTextProperty  ToStringList 
..  XCirculateSubwindowsDown 
..  XCirculateSubwindowsUp 
..  XConfigureWindow 
..  XLowerWindow 
..  XRaiseWindow 
..  XCirculatcSubwindows 
..  XRestackWindows 
..  XGetStandardColormap 
..  XSetStandardColormap 
..  XCreateFontCursor 
..  XParseGeometry 
..  XSetWMProperties 
..  XGetNormalHints 
..  XSetNormalHints 
..  XQueryKeymap 
..  XSetStipple 
..  XQueryBestStipple 
..  XQueryBestSize 
..  XDestroyRegion 
..  XFreeFont 
..  XrmPutFileDatabase 
..  XrmQPutResource 
..  XrmPutResource 
..  XStoreBuffer 
..  XSloreBytes 
..  XIntemAtom 
..  XKeysymToString 
..  XParseGeometry 
..  X  Query  TextExtenls  1 6 
..  XrmGetStringDatabase 
..  XrmQuarkToString 
..  XGeometry 
,.  XQueryTextExtents 
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XTextEx tents:  get 
16-bit/  /query  the  server  for 
16-bit/  XTextExtentsl6:  get 
/rebind  a  keysym  to  a 
X  Draw  String:  draw  an  8-bit  text 
/map  a  key  event  to  ASCII 
associated  with  the  specified 
metrics  of  a  16-bit  character 
in  pixels  of  an  8 -bit  character 
in  pixels  of  a  16-bit  character 
its  atom  XGetAtomName:  get  a 
quark  list  /convert  a  key 
/convert  a  keysym  name 
XrmStringToQuark:  convert  a 
/convert  a  key 
using  a  quark  resource  name  and 
draw  two-byte  text 
XDrawText:  draw  8-bit  polytext 
draw  16-bit  polytext 
resource  from  name  and  class  as 
XTextProperty/  /obtain  a  list  of 
/set  the  specified  list  of 
allocate  an  XClassHint 
allocate  an  XlconSize 
allocate  an  XSizeHints 
/allocate  an  XStandardColormap 
allocate  an  XWMHints 
allocate  memory  for  an  Xlmage 
an  entry  from  an  XModifierKeymap 
and  free  storage  for  the  font 
free  a  keyboard  modifier  mapping 
new  entry  to  an  XModifierKeymap 
load  a  font  and  fill  information 
corresponding  to  a  keycode  in 
a  keyboard  modifier  mapping 
set  an  XStandardColormap 
of  strings  to  an  XTextProperty 
from  a  specified  XTextProperty 
/obtain  the  XStandardColormap 
/find  the  visual  information 
XSetFillStyle:  set  the  fill 
XSublmage:  create  a 
XSubtractRegion : 
XChangeSaveSct:  add  or  remove  a 
XSetSubwindowMode:  set  the 
and  destroy  a  window  and  all 
XUnmapSubwindows:  unmap  all 
XDcstroySubwindows:  destroy  all 
XMapSubwindows:  map  all 
/change  the  keyboard  preferences 
/a  list  of  all  extensions  to  X 
/get  the  closest 
stipple/  /obtain  the  "best" 
/obtain  the  fastest 
XListPixmapFormats:  obtain  the 
/obtain  the  fastest 
/convert  a  keysym 
XGetKeyboardMapping:  return 


string  and  font  metrics  locally  ...... 

string  and  font  metrics  of  a  ........... 

string  and  font  metrics  of  a  ........... 

string  for  client  . . 

string,  foreground  only  ................. 

string,  keysym,  and/  ...................... 

string  list  /the  in-memory  data . 

string,  locally  /string  and  font  — .. 
string,  locally  /get  the  width  ......... 

string,  locally  /get  the  width . 

string  name  for  a  property  given  .. 
string  to  a  binding  list  and  a  ......... 

string  to  a  keysym . 

string  to  a  quark . 

string  to  a  quark  list . 

string  value  Ao  a  database . . 

strings  XDrawStringl6:  ............... 

strings . . 

strings  XDrawTextl6:  . . 

strings  XrmGetResource:  get  a  .... 

strings  from  a  specified . 

strings  to  an  XTextProperty/ . 

structure  XAllocClassHint: . 

structure  XAllocIconSize: . 

structure  XAllocSizeHints: . 

structure . 

structure  X Alloc WMHints: . 

structure  XCreatelmage:  . 

structure  /delete . 

structure  /unload  a  font  . 

structure  /destroy  and . 

structure  /add  a . 

structure  XLoadQueryFont: . 

structure  /get  the  keysym  . 

structure  /create . 

structure  XSetRGBColormaps:  ... 

structure  /the  specified  list  . 

structure  /a  list  of  strings . 

structure  associated  with  the/ . 

structures  that  match  the/ . 

style  in  a  graphics  context  ............ 

subimage  from  part  of  an  image  .. 
subtract  one  region  from  another  . 

subwindow  from  the  client’s/ . 

subwindow  mode  in  a  graphics/ ... 

subwindows,  /unmap . 

subwindows  of  a  given  window  ... 

subwindows  of  a  window . 

subwindows  of  window . 

such  as  key  click  ........................... 

supported  by  Xlib  and  the  server  . 

supported  cursor  sizes . . 

supported  cursor,  tile,  or . 

supported  fill  tile  shape . 

supported  pixmap  formats  for  a/ 
supported  stipple  shape ............... 

symbol  to  a  string . 

symbols  for  keycodes  ................... 


.......  XTextExtents 

... —  XQueryTextExtentsl6 
.......  XTextExtents  16 

.......  XRebindKeysym 

. . XDrawString 

.......  X  LookupString 

. XFreeStringList 

.......  XTextExtents  16 

_ _ XTextWidth 

_ _ XTextWidth  16 

.......  XGetAtomName 

.......  XrmStringToBindingQuarkList 

. . XStringToKeysym 

.......  XrmStringToQuark 

- XrmStringToQuarkList 

.......  XrmQPutStringResource 

.......  XDrawString  16 

. XDrawText 

- XDrawTextl6 

. XrmGetResource 

.......  XTextProperty ToStringList 

. XStringListToTextProperty 

. XAllocClassHint 

. XAllocIconSize 

.......  XAllocSizeHints 

. . XAllocStandardColormap 

. XAlloc  WMHints 

. XCreatelmage 

. XDeleteModifiermapEntry 

. XFreeFont 

. XFreeModifiermap 

. XInsertModifiermapEntry 

.......  XLoadQueryFont 

. XLookupKeysym 

. XNewModifiermap 

. XSetRGBColormaps 

. XStringListToTextProperty 

. XTextProperty  ToStringList 

.......  XGetRGBColormaps 

- XGetVisuallnfo 

.......  XSetFillStyle 

.......  XSublmage 

. . XSubtractRegion 

.......  XChangeSaveSet 

. XSetSubwindowMode 

. X  Destroy  Window 

. XUnmapSubwindows 

.......  XDcstroySubwindows 

. XMapSubwindows 

.......  XChangeKeyboardControl 

.......  XListExtensions 

.......  XQueryBestCursor 

. XQueryBestSize 

.......  XQueryBeslTile 

. XLislPixmapFormats 

.......  XQueryBestStipple 

- XKeysymToString 

.......  XGetKeyboardMapping 
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XSynchronize:  enable  or  disable 
another  /change  the  coordinate 
an  entry  from  an  association 
allocated  for  an  association 
obtain  data  from  an  association 
an  entry  in  an  association 
create  a  new  association 
that  match  the  specified 
/draw  8-bit  image 
/draw  16-bit  image 
/read  one  of  a  window’s 
/set  one  of  a  window’s 
XDrawString:  draw  an  8-bit 
XDrawStringl6:  draw  two-byte 
border  /change  a  window  border 
/change  the  background 
XSetTile:  set  the  fill 
the  "best"  supported  cursor, 
the  fastest  supported  fill 
graphics/  XSetTSOrigin:  set  the 
stacking  order  /circulate  the 
XMapRaised:  map  a  window  on 
/the  bottom  child  to  the 
/raise  a  window  to  the 
XI conify Window:  request  that  a 
/request  that  a 
XWithd  raw  Window:  request  that  a 
values  from  ASCII  color  name  or 
auto-repeat/  XAutoRepeatOff: 
keys  XAutoRepcatOn: 
XForceScreenSaver: 
/create  a  cursor  from 
XDrawLine:  draw  a  line  between 
compute  the  intersection  of 
compute  the  union  of 
the  union  and  intersection  of 
XEqualRegion:  determine  if 
XDrawString  16:  draw 
entry  for  a  given  window  and 
window  /obtain  the  atom 
the  next  event  in  queue  matching 
in  queue  that  matches  event 
Ao  a  window  and  context 
get  the  next  event  of  any 
/read  any  property  of 
/set  the  value  of  any  property  of 
XSelectlnput:  select  the  event 
default  if/  XUninstallColormap: 
/the  difference  between  the 
XUnionRegion:  compute  the 
XUnloadFont: 
for  the  font/  XFreeFont: 
XUnmapWindow: 
window  XUnmapSubwindows: 
all  subwindows.  XDestroy Window: 
XCreateSimpleWindow:  create  an 
/calculate  window  geometry  given 
/specification  to  a  database 


synchronization  for  debugging  .. . . 

system  from  one  window  to  . 

table.  XDeleteAssoc:  delete  ................. 

table,  /free  the  memory  . 

table  XLookUpAssoc: .......................... 

table  XMakeAssoc:  create . . 

table  (X10)  XCreateAssocTable: . 

template  /information  structures  .......... 

text  characters . 

text  characters . 

text  properties  ......... . .... 

text  properties  ................ _ .... 

text  string,  foreground  only  ......... _ ..... 

text  strings  ...................... _ ............ 

tile  attribute  and  repaint  the  .................. 

tile  attribute  of  a  window  . . 

tile  in  a  graphics  context . . ..... 

tile,  or  stipple  size  /obtain  .................... 

tile  shape  /obtain . 

tile/stipple  origin  in  a  . 

top  child  to  the  bottom  of  the 

top  of  its  siblings  . 

top  of  the  stacking  order  ....... 

top  of  the  stacking  order . 

top-level  window  be  iconified . 

top-level  window  be  reconfigured . 

top-level  window  be  withdrawn . 

translate  hexadecimal  value  /RGB  . 

turn  off  the  keyboard  . 

turn  on  the  keyboard  auto-repeat . 

turn  the  screen  saver  on  or  off . 

two  bitmaps  — . . 

two  points  . . 

two  regions  XIntersectRegion:  ............ 

two  regions  XUnionRegion:  . . 

two  regions  /difference  between . 

two  regions  have  the  same  size,/ - - 

two-byte  text  strings . 

type  /delete  a  context ... - ...... — 

type  and  property  format  for  a  - 

type  and  window  /return  . 

type;  don’t  wait  /the  next  event . 

type  (not  graphics  context)  . . 

type  or  window  XNextEvent: . 

type  XA_SIZE_HINTS  - 

type  XA_SIZE_HINTS  _ 

types  to  be  sent  to  a  window  . 

uninstall  a  colormap;  install . 

union  and  intersection  of  two/ .............. 

union  of  two  regions . 

unload  a  font.  . . 

unload  a  font  and  free  storage . 

unmap  a  window  .... — . . . 

unmap  all  subwindows  of  a  given - 

unmap  and  destroy  a  window  and  ....... 

unmapped  InputOutput  window  .......... 

user  geometry  string  and  default/ .... — 

using  a  quark  resource  name  and/ - 


.....  XSynchronize 

.....  XTranslate  Coordinates 

. XDeleteAssoc 

.....  XDestroyAssocTable 
.....  XLookUpAssoc 
.....  XMakeAssoc 
.....  XCreateAssocTable 
.....  XGetVisuallnfo 
.....  XDrawImageString 
.....  XDrawImageString  16 
.....  XGetTextProperty 
.....  XSetTextProperty 

—  XDrawString 
.....  XDrawString  16 

.....  XSetWindowBorderPixmap 
.....  XSetWindowBackgroundPixmap 

. XSetTile 

.....  X  Query  BestS  ize 
— .  XQueryBestTile 
.....  XSetTSOrigin 
.....  XCirculateSubwindowsUp 
.....  XMapRaised 

. XCirculateSubwindowsDown 

.....  XRaiseWindow 
.....  XI conify  Window 

. XReconfigureWMWindow 

. XWithdrawWindow 

.....  XParseColor 
.....  XAutoRepeatOff 
.....  XAutoRepeatOn 

. XForceScreenSaver 

. XCreatePixmapCursor 

.....  XDrawLine 
.....  XIntersectRegion 
.....  XUnionRegion 

. XXorRegion 

.....  XEqualRegion 

. XDrawStringl6 

.....  XDeleteContext 
.....  XGetWindowProperty 

. XCheckTypedWindowEvent 

.....  XCheckTyped  Event 

. XSaveContext 

. XNextEvent 

.....  XGetSizeHints 
.....  XSetSizeHints 

. XSelectlnput 

. XUninstallColormap 

.....  XXorRegion 

—  XUnionRegion 
.....  XUnloadFont 
.....  XFreeFont 

.....  XUnmapWindow 
.....  XUnmapSubwindows 
«...  XDestroy  Window 
.....  XCreateSimpleWindow 

. XGeometry 

. XrmQPutStringResource 
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/get  a  resource  value 
specification  into  a  database 
name  or  translate  hexadecimal 
with  separate  resource  name  and 
a  quark  resource  name  and  string 
/change  a  window  border  pixel 
/set  the  background  pixel 
and /  XSaveContext:  save  a  data 
XGetPixel:  obtain  a  single  pixel 
XGetDefault:  extract  an  option 
/set  the  background  pixel 
/set  the  foreground  pixel 
a  constant  value  to  every  pixel 
XPutPixel:  set  a  pixel 
XConvertSelection:  use  the 
XSetSizeHints:  set  the 
property  XSetlconSizes:  set  the 
image  XAddPixel:  add  a  constant 
XrmQGetResource:  get  a  resource 
with  depth,  applying  pixel 
XLookupColor:  get  database  RGB 
XQueryColor:  obtain  the  RGB 
XQuery Colors:  obtain  RGB 
XParseColor:  look  up  RGB 
closest  hardware-supported  RGB 
by/  XStoreNamedColor:  set  RGB 
entry  to/  /set  or  change  the  RGB 
to  the/  /set  or  change  the  RGB 
the/  XQueryKeymap:  obtain  a  bit 
draw  a  polyline  or  curve  between 
a  filled  polygon  or  curve  from 
obtain  the  visual  ID  from  a 
XVisuallDFromVisual:  obtain  the 
that/  XGetVisuallnfo:  find  the 
XMatchVisuallnfo:  obtain  the 
event  that  matches  mask;  don’t 
that  matches  event  type;  don’t 
window  and  passed  mask;  don’t 
to/  /flush  the  request  buffer  and 
predicate  procedure  XlfEvent: 
fails)  /report  the  display  name 
character/  XTextWidthl6:  get  the 
character/  XTextWidth:  get  the 
/change  the  border 
window  position,  size,  border 
a  property  associated  with  a 
event  in  queue  matching  type  and 
clear  a  rectangular  area  in  a 
XClearWindow:  clear  an  entire 
create  an  unmapped  InputOutput 
assign  a  cursor  to  a 
destroy  all  subwindows  of  a 
the  XA_WM_CLASS  property  of  a 
the  current  keyboard  focus 
property  of  a 
obtain  the  current  attributes  of 
type  and  property  format  for  a 
size  hints  property  of  a  zoomed 


using  name  and  class  as  quarks  ................  XrmQGetResource 

using  quarks  /store  a  resource  ..................  XrmQPutResource 

value  /values  from  ASCII  color . XParseColor 

value  /a  resource  specification . XrmPutStringResource 

value  /to  a  database  using  m.....................  XrmQPutStringResource 

value  attribute  and  repaint  the/  . . XSetWindowBorder 

value  attribute  of  a  window . XSetWindowBackground 

value  corresponding  to  a  window  ............  XSaveContext 

value  from  an  image  .................................  XGetPixel 

value  from  the  resource  database . XGetDefault 

value  in  a  graphics  context  .......................  XSetBackground 

value  in  a  graphics  context  . . XSetForeground 

value  in  an  image  /add  . XAddPixel 

value  in  an  image - ......... - ... - XPutPixel 

value  of  a  selection . XConvertSelection 

value  of  any  property  of  type/ . XSetSizeHints 

value  of  the  XA_WM_ICON_SIZE  . XSetlconSizes 

value  to  every  pixel  value  in  an  ....... - XAddPixel 

value  using  name  and  class  as/ . XrmQGetResource 

values  /drawable  into  a  drawable  . . XCopyPlane 

values  and  closest/ . XLookupColor 

values  and  flags  for  a  specified/ . XQueryColor 

values  for  an  array  of/  ...............................  XQucryColors 

values  from  ASCII  color  name  or/ . XParseColor 

values  from  color  name  /and  . XLookupColor 

values  of  a  read/write  colorcell  . XStoreNamedColor 

values  of  a  read/write  colormap . XStoreColor 

values  of  read/write  colorcells . XStoreColors 

vector  for  the  current  state  of . XQueryKeymap 

vertex  list  (from  X10)  XDraw:  . XDraw 

vertex  list  (from  X10)  /draw  . XDrawFilled 

Visual  XVisuallDFromVisual: . XVisuallDFromVisual 

visual  ID  from  a  Visual . XVisuallDFromVisual 

visual  information  structures . XGetVisuallnfo 

visual  information  that  matches/ . XMatchVisuallnfo 

wait  /remove  the  next . XCheckMask Event 

wait  /the  next  event  in  queue . XCheckTyped Event 

wait  /event  matching  both  passed . XCheckWindowEvent 

wail  for  all  events  and  errors  . XSync 

wait  for  event  matched  in  . XlfEvent 

(when  connection  to  a  display . XDisplayName 

width  in  pixels  of  a  16-bit . XTextWidth  16 

width  in  pixels  of  an  8-bit . XTextWidth 

width  of  a  window . XSetWindowBorderWidth 

width,  or  stacking  order  /the . XConfigureWindow 

window  XChangeProperty:  change  . XChangeProperty 

window  /return  the  next . XCheckTypedWindowEvent 

window  XClcarArea: . XClearArea 

window  . XClearWindow 

window  XCreateSimpleWindow: . XCreateSimpleWindow 

window  XDefineCursor: . XDefineCursor 

window  XDestroySubwindows: . XDeslroySubwindows 

window  XGetClassHint:  get . XGelClassIIint 

window  XGetlnputFocus:  return  .............  XGetlnputFocus 

window  /the  XA_WM_TRANSIENT_FOR  XGetTransientForHint 
window  XGetWindow Attributes: ............  XGetWindow Attributes 

window  /obtain  the  atom  . . XGetWindowProperty 

window  XGetZoomHints:  read  the  . XGetZoomllints 
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get  the  property  list  for  a 
map  all  subwindows  of 
XMapWindow:  map  a 
the  size  and  position  of  a 
XMoveWindow:  move  a 
the  next  event  of  any  type  or 
the  event  types  to  be  sent  to  a 
the  XA_WM_CLASS  property  of  a 
set  the  keyboard  focus 
property  for  a 
pixel  value  attribute  of  a 
background  tile  attribute  of  a 
change  the  border  width  of  a 
set  the  colormap  attribute  for  a 
size  hints  property  of  a  zoomed 
disassociate  a  cursor  from  a 
unmap  all  subwindows  of  a  given 
XUnmapWindow:  unmap  a 
matches  the  specified  mask  and 
/unmap  and  destroy  a 
/a  data  value  corresponding  to  a 
/insert  a  window  between  another 
/next  event  matching  both  passed 
XCreateWindow:  create  a 
a  context  entry  for  a  given 
XChangeWindow Attributes:  set 
/request  that  a  top-level 
/request  that  a  top-level 
/request  that  a  top-level 
and/  XRepa  rent  Window:  insert  a 
XSetWindowBorder:  change  a 
XSetWindowBorderPixmap:  change  a 
XStoreName:  assign  a  name  to  a 
XRemoveFromSaveSet:  remove  a 
geometry/  XGeometry:  calculate 
position  and  size  from  standard 
/get  the  size  hints  property  of  a 
/set  the  size  hints  property  of  a 
XLowerWindow:  lower  a 
set  of  properties  for  the 
a  name  to  a  window  for  the 
XGetWMHints:  read  the 
XSetWMHints:  set  a 
/set  a  window’s  standard 
XMapRaised:  map  a 
XPulImage:  draw  an  image  on  a 
XConfigureWindow:  change  the 
XDeleteProperty:  delete  a 
the  coordinate  system  from  one 
XAddToSaveSet:  add  a 
stacking/  XRaiseWindow:  raise  a 
XWM Geometry:  obtain  a 
the  name  to  be  displayed  in  a 
property)  XFetchName:  get  a 
XRe  size  Window:  change  a 
XSetWMProperties:  set  a 
XGetTextProperty:  read  one  of  a 
XSetTextProperty:  set  one  of  a 


window  XListProperties:  - — .........  XListProperties 

window  XMapSubwindows:  . XMapSub windows 

window  . . .......... . .  XMapWindow 

window  /change  ........................................  XMoveResizeWindow 

window  . . . . . XMoveWindow 

window  XNextEvent:  get . . XNextEvent 

window  XSelectlnput:  select  . . .  XSelectlnput 

window  XSetClassHint:  set  - - - - XSetClassHint 

window  XSetlnputFocus:  . . XSetlnputFocus 

window  /the  X A_WM_TRAN S IENT_FOR  XSetTransientForHint 

window  /set  the  background  . XSetWindowBackground 

window  /change  the . XSetWindowBackgroundPixmap 

window  XSetWindowBorderWidth: . XSetWindowBorderWidth 

window  XSetWindowColormap:  . XSetWindowColormap 

window  XSetZoomHints:  set  the .............  XSetZoomHints 

window  XUndefineCursor: . XUndefineCursor 

window  XUnmapSubwindows: . XUnmapSubwindows 

window  . . .  XUnmapWindow 

window  /the  next  event  that . XWindowEvent 

window  and  all  subwindows.  ..... - XDestroyWindow 

window  and  context  type  (not/ . XSaveContext 

window  and  its  parent . XReparentWindow 

window  and  passed  mask;  don’t/ - XCheckWindowEvent 

window  and  set  attributes . .  XCreateWindow 

window  and  type  /delete  . XDeleteContcxt 

window  attributes . XChangeWindow  Attributes 

window  be  iconified . Xlconify Window 

window  be  reconfigured . XReconfigureWMWindow 

window  be  withdrawn . XWithdrawWindow 

window  between  another  window  . XReparentWindow 

window  border  pixel  value/ . XSetWindowBorder 

window  border  tile  attribute  and/ . XSetWindowBorderPixmap 

window  for  the  window  manager  . XStoreName 

window  from  the  client’s/ . XRemoveFromSaveSet 

window  geometry  given  user . XGeometry 

window  geometry  string  /generate  .. . XParseGeometry 

window  in  normal  state  (not/ . XGetNormalHints 

window  in  normal  state  (not/ . XSetNormalHints 

window  in  the  stacking  order . XLowerWindow 

window  manager  /set  the  minimum  . XSetStandardProperties 

window  manager  /assign . XStoreName 

window  manager  hints  property . XGetWMHints 

window  manager  hints  property . XSetWMHints 

window  manager  properties  . . XSetWMProperties 

window  on  top  of  its  siblings  . XMapRaised 

window  or  pixmap  . . XPutlmage 

window  position,  size,  border / . XConfigureWindow 

window  property  . XDeleteProperty 

window  to  another  /change . XTranslateCoordinatcs 

window  to  the  client’s  save-set  ........... — .  XAddToSaveSet 

window  to  the  top  of  the . XRaiseWindow 

window’s  geometry  information  ..............  XWMGeometry 

window’s  icon  XSetlconName:  set .........  XSetlconName 

window’s  name  (XA_WM_NAME . XFetchName 

window’s  size  ............... . . . XResizeWindow 

window’s  standard  window  manager/  .....  XSetWMProperties 

window’s  text  properties  . . XGetTextProperty 

window’s  text  properties  - - XSetTextProperty 
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XSetWMQientMachine:  set  a 
XSetWMColormapWindows:  seta 
XSetWMProtocols:  set  a 
XSetWMSizeHints:  set  a 
property  XGetWMIconName:  read  a 
property  XSetWMIconName:  set  a 
XGetWMName:  read  a 
XSetWMName:  set  a 
XGetWMNormalHints:  read  a 
XSetWMNormalHints:  set  a 
XGetWMSizeHints:  read  a 
that  a  top-level  window  be 
/set  a  window’s 
/set  a  window’s 
XSetWMProtocols:  set  a  window’s 
XSetWMSizeHints:  set  a  window’s 
XWriteBitmapFile: 
connect  a  client  program  to  an 
a  client  program  from  an 
/a  list  of  all  extensions  to 
create  a  new  association  table 
curve  between  vertex  list  (from 
or  curve  from  vertex  list  (from 
/create  a  bitmap  from 
read  any  property  of  type 
value  of  any  property  of  type 
XGetClassHint:  get  the 
XSetClassHinl:  set  the 
arguments)  XSetCommand:  set  the 
XGetWMIconName:  read  a  window’s 
XSetWMIconName:  set  a  window’s 
/set  the  value  of  the 
XFetchName:  get  a  window’s  name 
XGetWMName:  read  a  window’s 
XSetWMName:  set  a  window’s 
/read  a  window’s 
/set  a  window’s 
XGetWMSizeHints:  read  a  window’s 
a/  XSetTransientForllint:  set  the 
a /  XGetTransientForHint:  get  the 
XAllocClassHint:  allocate  an 
free  the  memory  allocated  by 
XAllocIconSize:  allocate  an 
allocate  memory  for  an 
components  of  a  given  GC  from 
free  the  memory  allocated  by 
/free  the  memory  allocated  by 
/delete  an  entry  from  an 
/add  a  new  entry  to  an 
XAllocSizeHints:  allocate  an 
/allocate  an 
XSetRGBColormaps:  set  an 
XGetRGBColormaps:  obtain  the 
specified  list  of  strings  to  an 
list  of  strings  from  a  specified 
X Alloc WM Hints:  allocate  an 
of  a  window  in  normal  state  (not 
of  a  window  in  normal  state  (not 


window’s  WM_CUENT_MACHINE/  ...  XSetWMClientMachine 
window’s  WM_COLORMAP_WINIX)WS/  XSetWMColormapWindows 
window’s  WM_PROTOCOLS  property  .  XSetWMProtocols 
window’s  WM_SIZE_HINTS  property  ..  XSetWMSizeHints 


window’s  X A_WM_ICON_N AM E . XGetWMIconName 

window’s  XA_WM_ICON_NAME  _ _ XSetWMIconName 

window’s  XA_WM_NAME  property XGetWMName 

window’s  XA_WM_NAME  property XSetWMName 


window’s  XA_WM_NORMAL_HINTS/  XGetWMNormalHints 
window’s  XA_WM_NORMAL_HINTS/  XSetWMNormalHints 

window’s  XA_WM_SEE_HINTS/ . XGetWMSizeHints 

withdrawn  /request . XWithdrawWindow 

WM_CI  JRNT_MACHINE  property . XSetWMClientMachine 

WM_CO LORM AP_WINDOW S  property  XSetWMColormapWindows 

WM_PROTOCOLS  property . XSetWMProtocols 

WM_SEE_HINTS  property . XSetWMSizeHints 

write  a  bitmap  to  a  file  . . XWriteBitmapFile 

X  server  XOpen Display: . XOpenDisplay 

X  server  and  display  /disconnect ..... - XCloseDisplay 

X  supported  by  Xlib  and  the/ . XListExtensions 

(X10)  XCreateAssocTable: . XCreateAssocTable 

X10)  XDraw:  draw  a  polyline  or . XDraw 

X10)  /draw  a  filled  polygon  . . XDrawFilled 

XI 1  bitmap  format  data . XCreateBitmapFromData 

X A_SEE_HINTS  XGetSizeHints: . XGetSizellints 

XA_SEE_HINTS  /set  the . XSetSizeHints 

XA_WM_CLASS  property  of  a  window  .XGetClassHint 
XA_WM_CLASS  property  of  a  window  .XSetClassIIint 
XA_WM_COMMAND  atom  (command  line  XSetCommand 

XA_WM_ICON_NAME  property _ XGetWMIconName 

XA_WM_ICON_NAME  property  . XSetWMIconName 

XA_WM_ICON_SEE  property . XSetlconSizes 

(XA_WM_NAME  property) . XFetchName 

XA_WM_NAME  property . XGetWMName 

XA_WM_NAME  property . XSetWMName 

XA_WM_NORMAL_HINTS  property  ..  XGetWMNormalHints 
XA_WM_NORMAL_HINTS  property  ..  XSetWMNormalHints 

XA_WM_SEE_HINTS  property . XGetWMSizeHints 

XA_WM_TRANSIENT_FOR  property  for  XSetTransientForHint 
XA_WM_TRANSIENT_FOR  property  of  XGetTransientForHint 

XClassIIint  structure . XAllocClassHint 

XGetFontPath  XFreeFontPath:  . XFreeFontPath 

XlconSize  structure . XAllocIconSize 

Xlmage  structure  XCreatelmage: . XCreatelmage 

Xlib’s  GC  cache  /obtain . XGetGC Values 

XListFonts.  XFreeFontNames: - .....  XFreeFontNames 

XListFontsWithlnfo . XFreeFontlnfo 

XModifierKeymap  structure . XDeleteModifiermapEntry 

XModifierKeymap  structure  . XInsertModifiermapEntry 

XSizeHints  structure  .................................  XAllocSizeHints 

XStandardColormap  structure  . . XAllocStandardColormap 

XStandardColormap  structure . XSetRGBColormaps 

XStandardColormap  structure/ . XGetRGBColormaps 

XTextProperty  structure  /set  the . XStringListToTextProperty 

XTextProperty  structure  /a  .......................  XTextProperty ToStringList 

XWMHints  structure .................................  XAllocWMHints 

zoomed  or  iconified)  /property  — . — . XGetNormalHinis 

zoomed  or  iconified)  /property . XSetNormalHints 


30 


Xlib  Reference  Manual 


the  size  hints  property  of  a  zoomed  window  /read _ _ _ XGetZoomHints 

set  the  size  hints  property  of  a  zoomed  window  XSetZoomHints: . XSetZoomHints 
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—  Xlib  -  Function  Group 


Introduction 


J 

This  page  describes  the  format  of  each  reference  page  in  this  volume. 

Name 

XFunctionName  —  brief  description  of  the  function. 

Synopsis 

The  Synopsis  section  presents  the  calling  syntax  for  the  routine,  including  the  declarations  of 
the  arguments  and  return  type.  For  example: 

returntype  XFunctionName ( argl ,  arg2 ,  arg3) ; 
typel  argl ; 

type  2  *  a  rg2 ;  /*  RETURN  */ 

type 3  *arg3;  /*  SEND  and  RETURN  */ 

The  return  type  Status  is  of  type  int;  it  returns  either  True  or  False  to  indicate  whether 
the  routine  was  successful. 

Arguments 

The  Arguments  section  describes  each  of  the  arguments  used  by  the  function.  There  are  three 
sorts  of  arguments:  arguments  that  specify  data  to  the  function,  arguments  that  return  data  from 
the  function,  and  arguments  that  do  both.  An  example  of  each  type  is  shown  below: 

argl  Specifies  information  for  XFunctionName.  The  description  of  arguments  that 
pass  data  to  the  function  always  begins  with  the  word  “Specifies,”  as  shown  in  this 
example. 

arg2  Returns  a  pointer  to  data  to  be  filled  in  by  XFunctionName.  The  description  of 
arguments  that  return  data  from  the  function  always  begins  with  the  word 
“Returns.” 

arg3  Specifies  information  for  XFunctionName,  and  returns  data  from  the  function. 

The  description  of  arguments  that  both  pass  data  to  the  function  and  return  data 
from  the  function  uses  both  the  words  “Specifies”  and  “Returns.” 

Availability 

The  Availability  section  specifies  that  a  given  function  is  only  available  in  Release  4  and  later 
releases.  If  there  is  no  Availability  section,  the  function  is  available  prior  to  Release  4. 

Description 

The  Description  section  describes  what  the  function  does,  what  it  returns,  and  what  events  or 
side-effects  it  causes.  It  also  contains  miscellaneous  information  such  as  examples  of  usage, 
special  error  cases,  and  pointers  to  related  information  in  both  volumes  of  this  manual. 

Structures 

The  Structures  section  contains  the  C  definitions  of  the  X-specific  data  types  used  by 
FunctionName  as  arguments  or  return  values.  It  also  contains  definitions  of  important  con- 
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Introduction 


(continued) 


Xlib  -  Function  Group 


stants  used  by  the  function.  Additional  structures  not  shown  can  be  found  in  Appendix  F, 
Structure  Reference. 

Errors 

The  general  description  of  the  error  types  is  contained  in  Appendix  B,  Error  Messages  and  Pro¬ 
tocol  Requests.  Some  functions  generate  errors  due  to  function-specific  interpretation  of  argu¬ 
ments.  Where  appropriate,  these  function-specific  causes  have  been  listed  along  with  the  error 
event  types  they  generate. 

Related  Commands 

The  Related  Commands  section  lists  the  Xlib  functions  and  macros  related  to  XFunction- 
Name. 
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—  Xlib  -  Screen  Saver 


XActivateScreenSaver 


/ 


Name 

XActivateScreenSaver  —  activate  screen  blanking. 

Synopsis 

XActivateScreenSaver ( display ) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

Description 

XActivateScreenSaver  turns  on  the  screen  saver  using  the  parameters  set  with  XSet- 
ScreenSaver.  The  screen  saver  blanks  the  screen  or  makes  random  changes  to  the  display 
in  order  to  save  the  phosphors  from  burnout  when  the  screen  is  left  unattended  for  an  extended 
period  of  time.  The  interval  that  the  server  will  wait  before  starting  screen  save  activity  can  be 
set  with  XSetScreenSaver.  Exactly  how  the  screen  saver  works  is  server-dependent. 

For  more  information  on  the  screen  saver,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Related  Commands 

XForceScreenSaver, XGetScreenSaver,  XResetScreenSaver, XSetScreen¬ 
Saver. 
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XAddHost 


Xlib  -  Host  Access— 


\ 


Name 

XAddHost  —  add  a  host  to  the  access  control  list. 

Synopsis 

XAddHost ( display,  host) 

Display  * display ; 

XHostAddress  *host; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
host  Specifies  the  network  address  of  the  host  machine  to  be  added. 

Description 

XAddHost  adds  the  specified  host  to  the  access  control  list  for  the  server  specified  by  dis¬ 
play.  The  access  control  list  is  a  primitive  security  feature  that  allows  access  to  the  server 
only  by  other  machines  listed  in  a  file  on  the  machine  running  the  server.  On  UNIX-based  sys¬ 
tems,  this  file  is  called  /etc/X? .hosts,  where  ?  is  the  number  of  the  server. 

The  application  that  calls  XAddHost  and  the  server  whose  list  is  being  updated  must  be  run¬ 
ning  on  the  same  host  machine. 

The  address  data  must  be  a  valid  address  for  the  type  of  network  in  which  the  server  oper¬ 
ates,  as  specified  in  the  family  member.  Internet,  DECnet  and  ChaosNet  networks  are  cur¬ 
rently  supported. 

For  TCP/IP,  the  address  should  be  in  network  byte  order.  For  the  DECnet  family,  the  server 
performs  no  automatic  swapping  on  the  address  bytes.  A  Phase  IV  address  is  two  bytes  long. 
The  first  byte  contains  the  least  significant  eight  bits  of  the  node  number.  The  second  byte  con¬ 
tains  the  most  significant  two  bits  of  the  node  number  in  the  least  significant  two  bits  of  the 
byte,  and  the  area  in  the  most  significant  six  bits  of  the  byte. 

For  more  information  on  access  control,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques . 

Structures 

typedef  struct  { 
int  family; 
int  length; 
char  *address; 

}  XHostAddress; 

/*  The  following  constants  for  family  member  */ 

♦define  Familylnternet  0 

♦define  FamilyDECnet  1 

♦define  FamilyChaos  2 

Errors 

BadAccess 
BadValue 


/*  for  example  Familylnternet  */ 

/*  length  of  address,  in  bytes  */ 

/*  pointer  to  where  to  find  the  bytes  */ 
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Xlib  -  Host  Access 


(continued) 


XAddHost 


Related  Commands 

XAddHosts,  XDisableAccessControl,  XEnableAccessControl, XListHosts, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 
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XAddHosts 


Xlib  -  Host  Access — 


\ 


Name 

XAddHosts  —  add  multiple  hosts  to  the  access  control  list. 

Synopsis 

XAddHosts (  display,  hosts ,  num_hosts) 

Display  * display ; 

XHost Address  * hosts; 
int  num_hosts ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
hosts  Specifies  each  host  that  is  to  be  added. 

num_hosts  Specifies  the  number  of  hosts  that  are  to  be  added. 

Description 

XAddHosts  adds  each  specified  host  to  the  access  control  list  for  the  server  specified  by  dis¬ 
play.  The  access  control  list  is  a  primitive  security  feature  that  allows  access  to  the  server 
only  by  other  machines  listed  in  a  file  on  the  machine  running  the  server.  On  UNIX  systems, 
this  file  is  letc/X?. hosts,  where  ?  is  the  number  of  the  display. 

The  application  that  calls  XAddHosta  and  the  server  whose  list  is  being  updated  must  be  run¬ 
ning  on  the  same  host  machine. 

The  address  data  must  be  a  valid  address  for  the  type  of  network  in  which  the  server  oper¬ 
ates,  as  specified  by  the  family  member.  Internet,  DECnet  and  ChaosNet  networks  are  cur¬ 
rently  supported. 

For  TCP/IP,  the  address  should  be  in  network  byte  order.  For  the  DECnet  family,  the  server 
performs  no  automatic  swapping  on  the  address  bytes.  A  Phase  IV  address  is  two  bytes  long. 
The  first  byte  contains  the  least  significant  eight  bits  of  the  node  number.  The  second  byte  con¬ 
tains  the  most  significant  two  bits  of  the  node  number  in  the  least  significant  two  bits  of  the 
byte,  and  the  area  in  the  most  significant  six  bits  of  the  byte. 

For  more  information  on  access  control,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Structures 

typedef  struct  { 
int  family; 
int  length; 
char  *address; 

}  XHost Address; 

/*  The  following  constants  for  family  member  */ 

#define  Familylnternet  0 

#define  FamilyDECnet  1 

tdefine  FamilyChaos  2 


/*  for  example  Family  Internet  */ 

/*  length  of  address,  in  bytes  */ 

/*  pointer  to  where  to  find  the  bytes  */ 
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Xlib  -  Host  Access 


(continued) 


XAddHosts 


Errors 

BadAccess 

BadValue 

Related  Commands 

XAddHost,  XDisableAccessControl, XEnableAccessControl, XListHosts, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 
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XAddPixel 


Xlib  -  Images — 


\ 


Name 


XAddPixel  —  add  a  constant  value  to  every  pixel  value  in  an  image. 

Synopsis 

XAddPixel  (xi mage,  value) 

Xlmage  *ximage ; 
unsigned  long  value ; 

Arguments 

ximage  Specifies  a  pointer  to  the  image  to  be  modified. 

value  Specifies  the  constant  value  that  is  to  be  added.  Valid  pixel  value  ranges 


depend  on  the  visual  used  to  create  the  image.  If  this  value  added  to  the 
existing  value  causes  an  overflow,  extra  bits  in  the  result  are  truncated. 


Description 

XAddPixel  adds  a  constant  value  to  every  pixel  value  in  an  image.  This  function  is  useful 
when  you  have  a  base  pixel  value  derived  from  the  allocation  of  color  resources  and  need  to 
manipulate  an  image  so  that  the  pixel  values  are  in  the  same  range. 

For  more  information  on  images,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 


Structures 

typedef  struct  _XImage  { 


/*  size  of  image  */ 

/*  number  of  pixels  offset  in  X  direction  */ 
/*  XYBitmap,  XYPixmap,  ZPixmap  */ 

/*  pointer  to  image  data  */ 

/*  data  byte  order,  LSBFirst,  MSBFirst  */ 

/*  quantity  of  scan  line  8,  16,  32  */ 

/*  LSBFirst,  MSBFirst  */ 

/*  8,  16,  32  either  XY  or  ZPixmap  */ 

/*  depth  of  image  */ 

/*  accelerator  to  next  line  */ 

/*  bits  per  pixel  (ZPixmap)  */ 

/*  bits  in  z  arrangment  */ 


int  width,  height; 

int  xoffset; 

int  format; 

char  *data; 

int  byte_order; 

int  bitmap_unit; 

int  bitmap_bit_order; 

int  bitmap_pad; 

int  depth; 

int  bytes_per_line; 

int  bits_per_pixel; 

unsigned  long  red_mask; 

unsigned  long  green_mask; 

unsigned  long  blue_mask; 

char  *obdata; 

struct  funcs  { 


/*  hook  for  object  routines  to  hang  on  */ 
/*  image  manipulation  routines  */ 


struct  _XImage  * (*create_image) (); 
int  (*destroy_image) (); 
unsigned  long  (*get_pixel ) ( ) ; 
int  (*put_pixel) (); 
struct  _XImage  * (*sub_image) () ; 
int  (*add_pixel) (); 

}  f; 


}  Xlmage; 
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Xlib  -  Images 


(continued) 


XAddPixel 


Related  Commands 

ImageByteOrder,  XCreatelmage,  XDestroy Image,  XGetlmage,  XGetPixel, 
XGet Subimage,  XPut  Image,  XPutPixel,  XSublmage. 
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XAddToSaveSet 


Xlib-  Save  Set— 


\ 


Name 

XAddToSaveSet  —  add  a  window  to  the  client’s  save-set 

Synopsis 

XAddToSaveSet  ( display,  w) 

Display  * display ; 

Window  w ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  ID  of  the  window  you  want  to  add  to  the  client’s  save-set. 

Description 

XAddToSaveSet  adds  the  specified  window  to  the  client’s  save-set. 

The  save-set  is  a  safety  net  for  windows  that  have  been  reparented  by  the  window  manager, 
usually  to  provide  a  titlebar  or  other  decorations  for  each  application.  When  the  window  man¬ 
ager  dies  unexpectedly,  the  windows  in  the  save-set  are  reparented  to  their  closest  living  ances¬ 
tor,  so  that  they  remain  alive.  See  Volume  One,  Chapter  13,  Other  Programming  Techniques , 
for  more  information  about  save-sets. 

Use  XRemoveFromSaveSet  to  remove  a  window  from  the  client’s  save-set. 

Errors 

BadMatch  w  not  created  by  some  other  client. 

BadWindow 

Related  Commands 

XChangeSaveSet, XRemoveFromSaveSet. 
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XAIIocClassHint 


/ 


Name 

XAIIocClassHint  —  allocate  an  XClassHint  structure. 

Synopsis 

XClassHint  *XAllocClassHint ( ) 

Availability 

Release  4  and  later. 

Description 

XAIIocClassHint  allocates  and  returns  a  pointer  to  an  XClassHint  structure,  for  use  in 
calling  XSetWMProperties,  XGetClassHint,  or  XSetClassHint.  Note  that  the 
pointer  fields  in  the  XClassHint  structure  are  initially  set  to  NULL.  If  insufficient  memory  is 
available,  XAIIocClassHint  returns  null.  To  free  the  memory  allocated  to  this  structure, 
use  XFree. 

The  purpose  of  this  function  is  to  avoid  compiled-in  structure  sizes,  so  that  object  files  will  be 
binary  compatible  with  later  releases  that  may  have  new  members  added  to  structures. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Structures 

typedef  struct  { 

char  *res_name; 
char  *res_class; 

}  XClassHint; 

Related  Commands 

XGetClassHint, XSetClassHint, XSetWMProperties. 
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XAIIocColor 


Xllb  -  Color  Cells — 


\ 


Name 

XAIIocColor  —  allocate  a  read-only  colormap  cell  with  closest  hardware-supported  color. 

Synopsis 

Status  XAIIocColor ( display,  cmap,  colorcell_def) 

Display  * display ; 

Colormap  cmap; 

XColor  *colorcell_def;  /*  SENDs  and  RETURNS  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
cmap  Specifies  the  ID  of  the  colormap  in  which  the  colorcell  is  to  be  allocated. 

colorcell_def 

Specifies  desired  RGB  values,  and  also  returns  the  pixel  value  and  the  RGB  val¬ 
ues  actually  used  in  the  colormap. 

Description 

XAIIocColor  returns  in  the  XColor  structure  the  pixel  value  of  a  read-only  (shareable) 
colorcell  with  the  closest  RGB  values  available  in  cmap.  XAIIocColor  also  returns  the  red, 
green,  and  blue  values  actually  used. 

If  the  display  hardware  has  an  immutable  hardware  colormap,  the  entire  colormap  will  be  read¬ 
only,  and  the  closest  cell  that  exists  will  be  returned.  Otherwise,  the  colormap  is  read/write, 
and  may  have  some  read/write  cells,  some  read-only  cells,  and  some  unallocated  cells.  If  a 
read-only  cell  exists  that  matches  the  requested  RGB  values,  that  cell  is  returned.  If  no  match¬ 
ing  cell  exists  but  there  are  unallocated  cells,  a  cell  is  allocated  to  match  the  specified  RGB  val¬ 
ues.  If  no  matching  cell  exists  and  there  are  no  unallocated  cells,  XAIIocColor  returns  a 
Status  of  zero  (in  read/write  colormaps,  it  does  not  return  the  closest  available  read-only 
colorcell  that  has  already  been  allocated).  If  it  succeeds,  XAIIocColor  returns  nonzero. 

Note  that  colorcell_def  stores  both  the  requested  color  when  XAIIocColor  is  called 
and  the  result  when  XAIIocColor  returns. 

XAIIocColor  does  not  use  or  affect  the  flags  member  of  the  XColor  structure. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Structures 

typedef  struct  { 

unsigned  long  pixel; 

unsigned  short  red,  green,  blue; 

char  flags;  /*  DoRed,  DoGreen,  DoBlue  */ 

char  pad; 

}  XColor; 

Errors 

BadColormap 
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Related  Commands 

BlackPixel, WhitePixel, XAllocColorCells, XAllocColorPlanes, XAlloc- 
NamedColor, XFreeColors, XLookupColor, XParseColor,  XQueryColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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\ 


Name 

XAIIocColorCells  —  allocate  read/write  (nonshared)  colorcells. 

Synopsis 

Status  XAIIocColorCells ( display,  cmap ,  contig,  plane_masks , 
nplanes ,  pixels ,  ncolors) 

Display  ^display ; 

Colormap  cmap; 

Bool  contig ; 

unsigned  long  pi ane_masks  [nplanes]  ;  /*  RETURN  */ 
unsigned  int  nplanes ; 

unsigned  long  pixels  [ncolors]  ;  /*  RETURN  pixel  values  */ 

unsigned  int  ncolors; 


Arguments 

di  spl  ay 

cmap 

contig 

plane_mask 

nplanes 

pixels 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  ID  of  the  colormap  in  which  the  colorcell  is  to  be  allocated. 

Specifies  a  boolean  value.  Pass  True  if  the  planes  must  be  contiguous  or 
False  if  the  planes  need  not  be  contiguous. 

Returns  an  array  of  plane  masks. 

Specifies  the  number  of  plane  masks  returned  in  the  plane  masks  array.  Must 
be  nonnegative. 

Returns  an  array  of  pixel  values. 


ncolors  Specifies  the  number  of  pixel  values  returned  in  the  pixels  array.  Must  be 
positive. 

Description 

XAIIocColorCells  allocates  read/write  colorcells  in  a  read/write  colormap.  If  ncolors 
and  nplanes  are  requested,  then  ncolors  pixels  and  nplanes  plane  masks  are  returned. 
No  mask  will  have  any  bits  in  common  with  any  other  mask,  or  with  any  of  the  pixels.  By 
ORing  together  each  of  the  pixels  with  any  combination  of  the  plane_masks, 
ncolors*2(nPIafjes>  distinct  pixels  can  be  produced.  For  Grayscale  or  Pseudocolor, 
each  mask  will  have  exactly  one  bit,  and  for  DirectColor  each  will  have  exactly  three  bits. 
If  contig  is  True,  then  if  all  plane  masks  are  ORed  together,  a  single  contiguous  set  of  bits 
will  be  formed  for  Grayscale  or  Pseudocolor  and  three  contiguous  sets  of  bits  (one 
within  each  pixel  subfield)  for  DirectColor.  The  RGB  values  of  the  allocated  entries  are 
undefined  until  set  with  XStoreColor,  XStoreColors,  or  XStoreNamedColor. 


Status  is  zero  on  failure,  and  nonzero  on  success. 


For  more  information,  see  Volume  One,  Chapter  7,  Color. 
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Errors 

BadColormap 

BadValue  nplanes  is  negative. 

n colors  is  not  positive. 

Related  Commands 

BlackPixel, WhitePixel, XAllocColor,  XAllocColorPlanes, XAllocNamed- 
Color,  XFreeColors, XLookupColor, XParseColor,  XQueryColor, XQuery- 
Colors,  XStoreColor,  XStoreColors,  XStoreNamedColor. 
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Xlib  -  Color  Cells— 


\ 


Name 

XAIIocColorPlanes  —  allocate  read/write  (nonshareable)  color  planes. 

Synopsis 

Status  XAIIocColorPlanes ( display,  cmap ,  contig,  pixels ,  ncolors , 
nreds ,  ngreens ,  nblues ,  rmask,  gmask,  bmask) 

Display  ^display ; 

Colormap  cmap; 

Bool  contig ; 

unsigned  long  pixels  [ncolors]  ;  /*  RETURN  */ 

int  ncolors ; 

int  nreds,  ngreens,  nblues ; 

unsigned  long  * rmask,  * gmask,  * bmask;  /*  RETURN  */ 


Arguments 

di  spl  ay 

cmap 

contig 

pixels 

ncolors 

nreds 

ngreens 

nblues 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Specifies  the  ID  of  the  colormap  to  be  used. 

Specifies  a  boolean  value.  Pass  True  if  the  planes  must  be  contiguous  or 
False  if  the  planes  do  not  need  to  be  contiguous. 

Returns  an  array  of  pixel  values. 

Specifies  the  number  of  pixel  values  returned  in  the  pixels  array.  Must  be  posi¬ 
tive. 

Specify  the  number  of  red,  green,  and  blue  planes  (shades).  Must  be  nonnega¬ 
tive. 


rmask  Return  bit  masks  for  the  red,  green,  and  blue  planes. 

gmask 

bmask 

Description 

If  ncolors ,  nreds ,  ngreens ,  and  nblues  are  requested,  then  ncolors  pixels  are 
returned,  and  the  masks  have  nreds ,  ngreens ,  and  nblues  bits  set  to  1  respectively. 
Unique  pixel  values  are  generated  by  by  ORing  together  subsets  of  masks  with  each  item  in  the 
pixels  list  (pixels  does  not  by  itself  contain  pixel  values).  In  doing  this,  note  that 

ncolors*(2(nreds+ngreens+nbiues) )  distinct  pixel  values  are  allocated. 

If  contig  is  True,  then  each  mask  will  have  a  contiguous  set  of  bits.  No  mask  will  have  any 
bits  in  common  with  any  other  mask,  or  with  any  of  the  pixels.  For  DirectColor,  each 
mask  will  lie  within  the  corresponding  pixel  subfield. 

Note,  however,  that  there  are  actually  only  ncolors* (2 nreds  )  independent  red  entries, 
ncolors**  (2  n?reens  )  independent  green  entries,  and  ncolors*(2nblues )  independent  blue 
entries  in  the  colormap.  This  is  true  even  for  Pseudocolor.  This  does  not  cause  problems, 
though,  because  when  the  colormap  entry  for  a  pixel  value  is  changed  using  xstoreColors 
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or  XStoreNamedColor,  the  pixel  is  decomposed  according  to  rmask ,  gmask ,  and  bmask 
and  the  corresponding  pixel  subfield  entries  are  updated. 

Status  is  zero  on  failure,  and  nonzero  on  success. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadColormap 

BadValue  n colors  is  not  positive. 

At  least  one  of  nreds ,  ngreens ,  nbl  ues  is  negative. 

Related  Commands 

BlackPixel,  WhitePixel, XAllocColor,  XAllocColorCells, XAllocNamed- 
Color,  XFreeColors,  XLookupColor,  XParseColor,  XQueryColor,  XQuery- 
Colors,  XStoreColor,  XStoreColors,  XStoreNamedColor. 
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Xlib  -  Window  Manager  Hints — 


Name 

XAIIocIconSize  —  allocate  an  xiconSize  structure. 

Synopsis 

XiconSize  *XAllocIconSize (  ) 

Availability 

Release  4  and  later. 

Description 

XAIIocIconSize  allocates  and  returns  a  pointer  to  an  XiconSize  structure,  for  use  in  cal¬ 
ling  XGetlconSizes  or  XSetlconSizes.  Note  that  all  fields  in  the  XiconSize  struc¬ 
ture  are  initially  set  to  zero.  If  insufficient  memory  is  available,  XAIIocIconSize  returns 
null.  To  free  the  memory  allocated  to  this  structure,  use  XFree. 

The  purpose  of  this  function  is  to  avoid  compiled-in  structure  sizes,  so  that  object  files  will  be 
binary  compatible  with  later  releases  that  may  have  new  members  added  to  structures. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter client  Communication. 

Structures 

typedef  struct  { 

int  min_width,  min_height; 
int  max_width,  max_height; 
int  width_inc,  height_inc; 

}  XiconSize; 

Related  Commands 

XGetlconSizes, XSetlconSizes. 


50 


Xlib  Reference  Manual 


—  Xlib  -  Color  Cells 


XAIIocNamedColor 


/ 


Name 

XAIIocNamedColor  —  allocate  a  read-only  colorcell  from  color  name. 

Synopsis 

Status  XAIIocNamedColor ( display,  cmap,  colorname , 
colorcell_def ,  rgb_db_def) 

Display  *display ; 

Colo  rmap  cmap  ; 
char  * colorname ; 

XColor  * colorcell_def ;  /*  RETURN  */ 

XColor  * rgb_db_def ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
cmap  Specifies  the  ID  of  the  colormap  in  which  the  colorcell  will  be  allocated. 

colorname  Specifies  the  color  name  string  (for  example,  “red”)  you  want.  Upper  or 
lower  case  does  not  matter.  The  string  should  be  in  ISO  LATIN- 1  encoding, 
which  means  that  the  first  128  character  codes  are  ASCII,  and  the  second  128 
character  codes  are  for  special  characters  needed  in  western  languages  other 
than  English. 

colorcell_def 

Returns  the  pixel  value  and  RGB  values  actually  used  in  the  colormap.  This 
is  the  closest  color  supported  by  the  hardware. 

rgb_db_def  Returns  the  exact  RGB  values  from  the  database  corresponding  to  the 
colorname  supplied. 

Description 

XAIIocNamedColor  determines  the  RGB  values  for  the  specified  colorname  from  the 
color  database,  and  then  allocates  a  read-only  colorcell  with  the  closest  color  available,  as 
described  under  XAllocColor.  Both  the  ‘exact’  database  definition  of  the  color,  and  the 
color  actually  allocated  are  returned.  If  the  colormap  is  not  full,  the  RGB  values  allocated  are 
the  closest  supported  by  the  hardware.  If  the  colormap  is  full,  and  is  a  StaticColor, 
DirectColor,  or  StaticGray  visual  class,  XAIIocNamedColor  returns  the  closest 
read-only  colorcell  already  allocated,  and  does  not  actually  create  or  set  any  new  colorcell.  If 
the  colormap  is  full  and  is  a  Pseudocolor,  TrueColor,  or  Grayscale  visual  class, 
XAIIocNamedColor  fails  and  returns  zero. 

XAIIocNamedColor  returns  a  Status  of  zero  if  colorname  was  not  found  in  the  data¬ 
base  or  if  the  color  could  not  be  allocated.  The  function  returns  nonzero  when  it  succeeds. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 
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Errors 

BadColormap 

BadName 

Structures 

typedef  struct  { 

unsigned  long  pixel; 

unsigned  short  red,  green,  blue; 

char  flags;  /*  DoRed,  DoGreen,  DoBlue  */ 

char  pad; 

}  XColor; 

Related  Commands 

BlackPixel, WhitePixel, XAllocColor,  XAllocColorCells, XAllocColor- 
Planes,  XFreeColors,  XLookupColor,  XParseColor,  XQueryColor,  XQuery- 
Colors,  XStoreColor,  XStoreColors,  XStoreNamedColor. 
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Name 

XAIIocSizeHints  — allocate  an  XSizeHints  structure. 

Synopsis 

XSizeHints  ^XAIIocSizeHints ( ) 

Availability 

Release  4  and  later. 

Description 

XAIIocSizeHints  allocates  and  returns  a  pointer  to  an  XSizeHints  structure,  for  use  in 
calling  XSetWMProperties,  XSetWMNormalHints,  or  XGetWMNormalHints.  Note 
that  all  fields  in  the  XSizeHints  structure  are  initially  set  to  zero.  If  insufficient  memory  is 
available,  XAIIocSizeHints  returns  NULL.  To  free  the  memory  allocated  to  this  structure, 
use  XFree. 

The  purpose  of  this  function  is  to  avoid  compiled-in  structure  sizes,  so  that  object  files  will  be 
binary  compatible  with  later  releases  that  may  have  new  members  added  to  structures. 

For  more  information,  see  Volume  One,  Chapter  10, 1 nterclient  Communication. 

Structures 

typedef  struct  { 

long  flags;  /*  marks  which  fields  in  this  structure  are  defined  */ 

int  x,  y;  /*  Obsolete  */ 

int  width,  height;  /*  Obsolete  */ 

int  min_width,  min_height; 

int  max_width,  max_height; 

int  width_inc,  height_inc; 

struct  { 

int  x;  /*  numerator  */ 

int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 
int  base_width,  base_height; 
int  win_gravity; 

}  XSizeHints; 

Related  Commands 

XGetWMNormalHints,  XSetWMNormalHints,  XSetWMProperties. 
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Name 

XAIIocStandardColormap  — allocate  an  XStandardColormap  structure. 

Synopsis 

XStandardColormap  ^XAIIocStandardColormap (  ) 

Availability 

Release  4  and  later. 

Description 

XAIIocStandardColormap  allocates  and  returns  a  pointer  to  an  XStandardColormap 
structure  for  use  in  calling  XGetRGBColormaps  or  XSetRGBColormaps.  Note  that  all 
fields  in  the  XStandardColormap  structure  are  initially  set  to  zero.  If  insufficient  memory 
is  available,  XAIIocStandardColormap  returns  null.  To  free  the  memory  allocated  to 
this  structure,  use  XFree. 

The  purpose  of  this  function  is  to  avoid  compiled-in  structure  sizes,  so  that  object  files  will  be 
binary  compatible  with  later  releases  that  may  have  new  members  added  to  structures. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Structures 

/*  value  for  killid  field  */ 

♦define  ReleaseByFreeingColormap  (  (XID)  1L) 

typedef  struct  { 

Colormap  colormap; 
unsigned  long  red_max; 
unsigned  long  red_mult; 
unsigned  long  green_max; 
unsigned  long  green_mult; 
unsigned  long  blue_max; 
unsigned  long  blue_mult; 
unsigned  long  base_pixel; 

VisuallD  visualid; 

XID  killid; 

}  XStandardColormap; 

Related  Commands 

XGetRGBColormaps,  XSetRGBColormaps. 
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/ 


Name 

XAIIocWMHints  —  allocate  an  XWMHints  structure. 

Synopsis 

XWMHints  ^XAIIocWMHints ( ) 

Availability 

Release  4  and  later. 

Description 

The  XAIIocWMHints  function  allocates  and  returns  a  pointer  to  an  XWMHints  structure,  for 
use  in  calling  XSetWMProperties,  XSetWMHints,  or  XGetWMHints.  Note  that  all  fields 
in  the  XWMHints  structure  are  initially  set  to  zero.  If  insufficient  memory  is  available, 
XAIIocWMHints  returns  null.  To  free  the  memory  allocated  to  this  structure,  use  XFree. 

The  purpose  of  this  function  is  to  avoid  compiled-in  structure  sizes,  so  that  object  files  will  be 
binary  compatible  with  later  releases  that  may  have  new  members  added  to  structures. 

For  more  information,  see  Volume  One,  Chapter  \0,  Inter  client  Communication. 

Structures 

typedef  struct  { 
long  flags; 

Bool  input; 

int  initial_state; 

Pixmap  icon_pixmap; 

Window  icon_window; 
int  icon_x,  icon_y; 

Pixmap  icon_mask; 

XID  window_group; 

/*  this  structure  may  be  extended  in  the  future  */ 

}  XWMHints; 

Related  Commands 

XGetWMHints,  XSetWMHints,  XSetWMProperties. 


/*  marks  which  fields  in  this  structure  are  defined  */ 
/*  does  this  application  rely  on  the  window  manager 
to  get  keyboard  input?  */ 

/*  see  below  */ 

/*  pixmap  to  be  used  as  icon  */ 

/*  window  to  be  used  as  icon  */ 

/*  initial  position  of  icon  */ 

/*  pixmap  to  be  used  as  mask  for  icon_pixmap  */ 

/*  id  of  related  window  group  */ 
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\ 


Name 

XAIIowEvents  —  control  the  behavior  of  keyboard  and  pointer  events  when  these  resources  are 
grabbed. 


Synopsis 

XAIIowEvents  ( display,  event_mode,  time) 
Display  ^display ; 
int  event_mode ; 

Time  time; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

event_mode  Specifies  the  event  mode.  Pass  one  of  these  constants:  AsyncPointer, 
SyncPointer,  AsyncKeyboard,  SyncKeyboard,  ReplayPointer, 
ReplayKeyboard,  AsyncBoth,  or  SyncBoth. 

time  Specifies  the  time  when  the  grab  should  take  place.  Pass  either  a  timestamp, 

expressed  in  milliseconds,  or  the  constant  CurrentTime. 

Description 

XAIIowEvents  releases  the  events  queued  in  the  server  since  the  last  XAIIowEvents  call 
for  the  same  device  and  by  the  same  client.  Events  are  queued  in  the  server  (not  released  to 
Xlib  to  propagate  into  Xlib’s  queues)  only  when  the  client  has  caused  a  device  to  “freeze”  (by 
grabbing  the  device  with  mode  GrabModeSync).  The  request  has  no  effect  if  time  is  earlier 
than  the  last-grab  time  or  later  than  the  current  server  time. 

The  event_mode  argument  controls  what  device  events  are  released  for  and  just  how  and 
when  they  are  released.  The  event_mode  is  interpreted  as  follows: 

AsyncPointer  If  XAIIowEvents  is  called  with  AsyncPointer  while  the 

pointer  is  frozen  by  the  client,  pointer  event  processing  resumes  nor¬ 
mally,  even  if  the  pointer  is  frozen  twice  by  the  client  on  behalf  of 
two  separate  grabs.  AsyncPointer  has  no  effect  if  the  pointer  is 
not  frozen  by  the  client,  but  the  pointer  need  not  be  grabbed  by  the 
client. 


AsyncKeyboard  If  XAIIowEvents  is  called  with  AsyncKeyboard  while  the  key¬ 

board  is  frozen  by  the  client,  keyboard  event  processing  resumes 
normally,  even  if  the  keyboard  is  frozen  twice  by  the  client  on  behalf 
of  two  separate  grabs.  AsyncKeyboard  has  no  effect  if  the  key¬ 
board  is  not  frozen  by  the  client,  but  the  keyboard  need  not  be 
grabbed  by  the  client. 

SyncPointer  If  XAIIowEvents  is  called  with  SyncPointer  while  the  pointer 

is  frozen  by  the  client,  normal  pointer  event  processing  continues 
until  the  next  ButtonPress  or  ButtonRelease  event  is 
reported  to  the  client.  At  this  time,  the  pointer  again  appears  to 
freeze.  However,  if  the  reported  event  causes  the  pointer  grab  to  be 


56 


Xlib  Reference  Manual 


Xlib  -  Input  Handling 


(continued) 


XAIIowEvents 


SyncKeyboa  rd 


ReplayPointer 


ReplayKeyboard 


SyncBoth 


AsyncBoth 


released,  then  the  pointer  does  not  freeze,  which  is  the  case  when  an 
automatic  grab  is  released  by  a  ButtonRe lease  or  when  XGrab- 
Button  or  XGrabKey  has  been  called  and  the  specified  key  or  but¬ 
ton  is  released.  SyncPointer  has  no  effect  if  the  pointer  is  not 
frozen  or  not  grabbed  by  the  client. 

If  XAIIowEvents  is  called  with  SyncKeyboa  rd  while  the  key¬ 
board  is  frozen  by  the  client,  normal  keyboard  event  processing  con¬ 
tinues  until  the  next  KeyPress  or  KeyRe lease  event  is  reported 
to  the  client.  At  this  time,  the  keyboard  again  appears  to  freeze. 
However,  if  the  reported  event  causes  the  keyboard  grab  to  be 
released,  then  the  keyboard  does  not  freeze,  which  is  the  case  when 
an  automatic  grab  is  released  by  a  ButtonRelease  or  when 
XGrabButton  or  XGrabKey  has  been  called  and  the  specified  key 
or  button  is  released.  SyncKeyboa  rd  has  no  effect  if  the  keyboard 
is  not  frozen  or  not  grabbed  by  the  client. 

This  symbol  has  an  effect  only  if  the  pointer  is  grabbed  by  the  client 
and  thereby  frozen  as  the  result  of  an  event  In  other  words, 
XGrabButton  must  have  been  called  and  the  selected  button/key 
combination  pressed,  or  an  automatic  grab  (initiated  by  a  Butt on - 
Press)  must  be  in  effect,  or  a  previous  XAIIowEvents  must  have 
been  called  with  mode  SyncPointer.  If  the  pointer_mode  of 
the  XGrabPointer  was  GrabModeSync,  then  the  grab  is 
released  and  the  releasing  event  is  processed  as  if  it  had  occurred 
after  the  release,  ignoring  any  passive  grabs  at  or  above  in  the  hierar¬ 
chy  (towards  the  root)  on  the  grab- window  of  the  grab  just  released. 

This  symbol  has  an  effect  only  if  the  keyboard  is  grabbed  by  the  cli¬ 
ent  and  if  the  keyboard  is  frozen  as  the  result  of  an  event.  In  other 
words,  XGrabKey  must  have  been  called  and  the  selected  key  com¬ 
bination  pressed,  or  a  previous  XAIIowEvents  must  have  been 
called  with  mode  SyncKeyboard.  If  the  pointer_mode  or 
keyboard_mode  of  the  XGrabKey  was  GrabModeSync,  then 
the  grab  is  released  and  the  releasing  event  is  processed  as  if  it  had 
occurred  after  the  release,  ignoring  any  passive  grabs  at  or  above  in 
the  hierarchy  (towards  the  root). 

SyncBoth  has  the  effect  described  for  both  SyncKeyboard  and 
SyncPointer.  SyncBoth  has  no  effect  unless  both  pointer  and 
keyboard  are  frozen  by  the  client.  If  the  pointer  or  keyboard  is  fro¬ 
zen  twice  by  the  client  on  behalf  of  two  separate  grabs,  SyncBoth 
“thaws”  for  both  (but  a  subsequent  freeze  for  SyncBoth  will  only 
freeze  each  device  once). 

AsyncBoth  has  the  effect  described  for  both  AsyncKeyboard 
and  AsyncPointer.  AsyncBoth  has  no  effect  unless  both 
pointer  and  keyboard  are  frozen  by  the  client.  If  the  pointer  and  the 
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keyboard  were  frozen  by  the  client,  or  if  both  are  frozen  twice  by 
two  separate  grabs,  event  processing  (for  both  devices)  continues 
normally.  If  a  device  is  frozen  twice  by  the  client  on  behalf  of  the 
two  separate  grabs,  AsyncBoth  releases  events  for  both. 

AsyncPointer,  SyncPointer,  and  ReplayPointer  have  no  effect  on  the  processing  of 
keyboard  events.  AsyncKeyboard,  SyncKeyboard,  and  ReplayKeyboard  have  no 
effect  on  the  processing  of  pointer  events. 

It  is  possible  for  both  a  pointer  grab  and  a  keyboard  grab  (by  the  same  or  different  clients)  to  be 
active  simultaneously.  If  a  device  is  frozen  on  behalf  of  either  grab,  no  event  processing  is  per¬ 
formed  for  the  device.  It  is  also  possible  for  a  single  device  to  be  frozen  because  of  both  grabs. 
In  this  case,  the  freeze  must  be  released  on  behalf  of  both  grabs  before  events  will  be  released. 

For  more  information  on  event  handling,  see  Volume  One,  Chapter  9,  The  Keyboard  and 
Pointer. 

Errors 

BadValue  Invalid  mode  constant. 

Related  Commands 

QLength, XChecklfEvent,  XCheckMaskEvent,  XCheckTypedEvent, XCheck- 
TypedWindowEvent, XCheckWindowEvent, XEventsQueued,  XGetlnputFocus, 
XGetMotionEvents, XlfEvent, XMaskEvent, XNextEvent,  XPeekEvent,  XPeek- 
IfEvent, XPending,  XPutBackEvent,  XSelectlnput,  XSendEvent,  XSetlnput- 
Focus, XSynchronize, XWindowEvent. 
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/ 


Name 

XAutoRepeatOff  —  turn  off  the  keyboard  auto-repeat  keys. 

Synopsis 

XAutoRepeatOff  ( display ) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Description 

XAutoRepeatOff  turns  off  auto-repeat  for  the  keyboard.  It  sets  the  keyboard  so  that  holding 
any  non-modal  key  down  will  not  result  in  multiple  events. 

Related  Commands 

XAutoRepeatOn, XBell, XChangeKeyboardControl, XGetDef ault,  XGet- 
KeyboardControl, XGetPointerControl. 
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\ 


Name 

XAutoRepeatOn  —  turn  on  the  keyboard  auto-repeat  keys. 

Synopsis 

XAutoRepeatOn  ( display ) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Description 

XAutoRepeatOn  sets  the  keyboard  to  auto-repeat;  that  is,  holding  any  non-modal  key  down 
will  result  in  multiple  KeyPress  and  KeyRelease  event  pairs  with  the  same  keycode 
member.  Keys  such  as  Shift  Lock  will  still  not  repeat. 

Related  Commands 

XAutoRepeatOf f , XBell,  XChangeKeyboardControl,  XGetDefault,  XGet- 
KeyboardControl, XGetPointerControl. 
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XBell 


/ 


Name 

XBell  —  ring  the  bell  (Control  G). 

Synopsis 

XBe  1 1  (  di  spl  ay,  percen  t ) 

Display  ^display ; 
int  percent ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

percent  Specifies  the  volume  for  the  bell,  relative  to  the  base  volume  set  with 

XChangeKeyboardControl.  Possible  values  are  -100  (off),  through  0 
(base  volume),  to  100  (loudest)  inclusive. 

Description 

Rings  the  bell  on  the  keyboard  at  a  volume  relative  to  the  base  volume,  if  possible,  percent 
can  range  from  -100  to  100  inclusive  (else  a  BadValue  error).  The  volume  at  which  the  bell 
is  rung  when  percent  is  nonnegative  is: 

volume  =  base  -  [ (base  *  percent)  /  100]  +  percent 

and  when  percent  is  negative: 

volume  =  base  +  [ (base  *  percent)  /  100] 

To  change  the  base  volume  of  the  bell,  set  the  bell_percent  variable  of  XChange¬ 
KeyboardControl. 

Errors 

BadValue  percent  <  -100  or  percent  >100. 

Related  Commands 

XAutoRepeatOf f , XAutoRepeatOn,  XChangeKeyboardControl, XGetDefault, 
XGetKeyboardControl, XGetPointerControl. 
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Name 

XChangeActivePointerGrab  —  change  the  parameters  of  an  active  pointer  grab. 

Synopsis 

XChangeActivePointerGrab ( display,  event_mask,  cursor,  time) 
Display  ^display ; 
unsigned  int  event_mask; 

Cursor  cursor; 

Time  time; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 

event_mask  Specifies  which  pointer  events  are  reported  to  the  client.  This  mask  is  the  bit¬ 
wise  OR  of  one  or  more  of  these  pointer  event  masks:  ButtonPressMask, 
ButtonReleaseMask,  EnterWindowMask,  LeaveWindowMask, 
PointerMotionMask,  PointerMotionHintMask,  Buttonl- 
MotionMask,  Button2MotionMask,  Button3MotionMask,  But- 
ton4MotionMask,  Button5MotionMask,  ButtonMotionMask, 
KeymapStateMask. 

cursor  Specifies  the  cursor  that  is  displayed.  A  value  of  None  will  keep  the  current 

cursor. 

time  Specifies  the  time  when  the  grab  should  take  place.  Pass  either  a  timestamp, 

expressed  in  milliseconds,  or  the  constant  Cur  rent  Time. 

Description 

XChangeActivePointerGrab  changes  the  characteristics  of  an  active  pointer  grab,  if  the 
specified  time  is  no  earlier  than  the  last  pointer  grab  time  and  no  later  than  the  current  X  server 
time.  XChangeActivePointerGrab  has  no  effect  on  the  passive  parameters  of  XGrab- 
Button,  or  the  automatic  grab  that  occurs  between  ButtonPress  and  ButtonRelease. 

event_mask  is  always  augmented  to  include  ButtonPress  and  ButtonRelease. 

For  more  information  on  pointer  grabbing,  see  Volume  One,  Chapter  9,  The  Keyboard  and 
Pointer. 

Errors 

BadCursor 

BadValue  The  event_mask  argument  is  invalid. 

Related  Commands 

XChangePointerControl, XGetPointerControl,  XGetPointerMapping, 
XGrabPointer, XQueryPointer,  XSetPointerMapping,  XUngrabPointer, 
XWarpPointer. 
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XChangeGC 


/ 


Name 

XChangeGC  —  change  the  components  of  a  given  graphics  context. 

Synopsis 

XChangeGC  ( display,  gc ,  valuemask,  values) 
Display  * display ; 

GC  gc; 

unsigned  long  valuemask ; 

XGCValues  *  values ; 


Arguments 

di  spl  ay 
gc 

valuemask 


values 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  graphics  context. 

Specifies  the  components  in  the  graphics  context  that  you  want  to  change. 
This  argument  is  the  bitwise  OR  of  one  or  more  of  the  GC  component  masks. 

Specifies  a  pointer  to  the  XGC Values  structure. 


Description 

XChangeGC  changes  any  or  all  of  the  components  of  a  GC.  The  valuemask  specifies  which 
components  are  to  be  changed;  it  is  made  by  combining  any  number  of  the  mask  symbols  listed 
in  the  Structures  section  using  bitwise  OR  (|).  The  values  structure  contains  the  values  to  be 
set.  These  two  arguments  operate  just  like  they  do  in  XCreateGC.  Changing  the 
clip_mask  overrides  any  previous  XSetClipRectangles  request  for  this  GC.  Changing 
the  dash_of  f  set  or  dash_list  overrides  any  previous  XSetDashes  request  on  this  GC. 


Since  consecutive  changes  to  the  same  GC  are  buffered,  there  is  no  performance  advantage  to 
using  this  routine  over  the  routines  that  set  individual  members  of  the  GC. 


Even  if  an  error  occurs,  a  subset  of  the  components  may  have  already  been  altered. 


For  more  information,  see  Volume  One,  Chapter  5,  The  Graphics  Context ,  and  Chapter  6, 
Drawing  Graphics  and  Text. 


Structures 

typedef  struct  { 

int  function; 

unsigned  long  plane_mask; 

unsigned  long  foreground; 

unsigned  long  background; 

int  line_width; 

int  line_style; 

int  cap_style; 

int  join_style; 

int  fill_style; 

int  fill_rule; 

int  arc_mode; 

Pixmap  tile; 

Pixmap  stipple; 
int  ts_x_origin; 


/*  logical  operation  */ 

/*  plane  mask  */ 

/*  foreground  pixel  */ 

/*  background  pixel  */ 

/*  line  width  */ 

/*  LineSolid,  LineOnOf fDash,  LineDoubleDash  */ 

/*  CapNotLast,  CapButt,  CapRound,  CapPro jecting  */ 
/*  JoinMiter,  JoinRound,  JoinBevel  */ 

/*  FillSolid,  FillTiled,  FillStippled  */ 

/*  EvenOddRule,  WindingRule  */ 

/*  ArcChord,  ArcPieSlice  */ 

/*  tile  pixmap  for  tiling  operations  */ 

/*  stipple  1  plane  pixmap  for  stipping  */ 

/*  offset  for  tile  or  stipple  operations  */ 
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int 

ts_y_origin; 

Font  font; 

/*  default  text  font  for  text  operations  *, 

int 

subwindow  mode; 

/*  ClipByChildren,  Includelnferiors  */ 

Bool  graphics_exposures; 

/*  generate  events  on  XCopy,  Area,  XCopyPl. 

int 

clip  x  origin; 

/*  origin  for  clipping  */ 

int 

clip_y_origin; 

Pixmap  clip_mask; 

/*  bitmap  clipping;  other  calls  for  rects 

int 

dash_of f set; 

/*  patterned/dashed  line  information  */ 

char  dashes; 

}  XGCValues; 

#define 

GCFunction 

(1L«0) 

#define 

GCPlaneMask 

(1L«1 ) 

#def ine 

GCForeground 

(1L«2) 

#def ine 

GCBackground 

(1L«3) 

#define 

GCLineWidth 

(1L«4) 

#def ine 

GCLineStyle 

(1L«5) 

#def ine 

GCCapStyle 

(1L«6) 

# def ine 

GC JoinStyle 

(1L«7) 

tdefine 

GCFillStyle 

(1L«8) 

#def ine 

GCFillRule 

(1L«9) 

#def ine 

GCTile 

(1L«10) 

#def ine 

GCStipple 

(1L«11) 

#define 

GCTileStipXOrigin 

(1L«12) 

#def ine 

GCTileStipYOrigin 

(1L«13) 

# def ine 

GCFont 

(1L«14) 

#def ine 

GCSubwindowMode 

(1L«15) 

#def ine 

GCGraphicsExposures 

(1L«16) 

#def ine 

GCClipXOrigin 

(1L«17) 

# def ine 

GCClipYOrigin 

(1L«18) 

#define 

GCClipMask 

(1L«19) 

#define 

GCDashOf f set 

(1L«20) 

#def ine 

GCDashList 

(1L«21) 

#define 

GCArcMode 

(1L«22) 

Errors 

BadAlloc 

BadFont 

BadGC 

BadMatch 

BadPixmap 

BadValue 

Related  Commands 

Def  aultGC,  XCopyGC,  XCreateGC,  XFreeGC,  XGContextFromGC,  XGetGCValues, 
XSetArcMode,  XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule,  XSetFillStyle,  XSetForeground, 
XSetFunction,  XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetRegion, XSetState,  XSetStipple,  XSetSubwindowMode,  XSet- 
TSOrigin. 
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Name 

XChangeKeyboardControl  —  change  the  keyboard  preferences  such  as  key  click. 

Synopsis 

XChangeKeyboardControl (display,  value_mask,  values) 

Display  ^display ; 
unsigned  long  value_mask ; 

XKeyboardControl  * values; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

value_mask  Specifies  a  mask  composed  of  ORed  symbols  from  the  table  shown  in  the 
Structures  section  below,  specifying  which  fields  to  set. 

val  ues  Specifies  the  settings  for  the  keyboard  preferences. 

Description 

XChangeKeyboardControl  sets  user  preferences  such  as  key  click,  bell  volume  and  dura¬ 
tion,  light  state,  and  keyboard  auto-repeat.  Changing  some  or  all  these  settings  may  not  be  pos¬ 
sible  on  all  servers. 

The  value_mask  argument  specifies  which  values  are  to  be  changed;  it  is  made  by  combin¬ 
ing  any  number  of  the  mask  symbols  listed  in  the  Structures  section  using  bitwise  OR  (|). 

The  values  structure  contains  the  values  to  be  set,  as  follows: 

key_click_percent  sets  the  volume  for  key  clicks  between  0  (off)  and  100  (loud)  inclu¬ 
sive.  Setting  to  -1  restores  the  default. 

bell_percent  sets  the  base  volume  for  the  bell  between  0  (off)  and  100  (loud)  inclusive. 
Setting  to  -1  restores  the  default. 

bell_j?itch  sets  the  pitch  (specified  in  Hz)  of  the  bell.  Setting  to  -1  restores  the  default. 

bell_duration  sets  the  duration  (specified  in  milliseconds)  of  the  bell.  Setting  to  -1 
restores  the  default. 

led_mode  is  either  LedModeOn  or  LedModeOf  f .  led  is  a  number  between  1  and  32  inclu¬ 
sive  that  specifies  which  light’s  state  is  to  be  changed.  If  both  led_mode  and  led  are  speci¬ 
fied,  then  the  state  of  the  LED  specified  in  led  is  changed  to  the  state  specified  in  led_mode. 
If  only  led_mode  is  specified,  then  all  the  LEDs  assume  the  value  specified  by  led_mode. 

auto_repeat_mode  is  either  AutoRepeatModeOn,  AutoRepeatModeOf  f ,  or  Auto- 
RepeatModeDef ault.  key  is  a  keycode  between  7  and  255  inclusive.  If  both 
auto_repeat_mode  and  key  are  specified,  then  the  auto-repeat  mode  of  the  key  specified 
by  key  is  set  as  specified  by  auto_repeat_mode.  If  only  auto_repeat_mode  is  speci¬ 
fied,  then  the  global  auto  repeat  mode  for  the  entire  keyboard  is  changed,  without  affecting  the 
settings  for  each  key.  If  the  auto_repeat_mode  is  AutoRepeatModeDef ault  for 
either  case,  the  key  or  the  entire  keyboard  is  returned  to  its  default  setting  for  the  server,  which 
is  normally  to  have  all  non-modal  keys  repeat. 
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When  a  key  is  being  used  as  a  modifier  key,  it  does  not  repeat  regardless  of  the  individual  or 
global  auto  repeat  mode. 

The  order  in  which  the  changes  are  performed  is  server-dependent,  and  some  may  be  completed 
when  another  causes  an  error. 

For  more  information  on  user  preferences,  see  Volume  One,  Chapter  9,  The  Keyboard  and 
Pointer. 

Structures 

/*  masks  for  ChangeKeyboardControl  */ 


#define  KBKeyClickPercent  (1L«0) 
#define  KBBellPercent  (1L«1) 
tdefine  KBBellPitch  (1L«2) 
#define  KBBellDuration  (1L«3) 
#def ine  KBLed  (1L«4) 
#define  KBLedMode  (1L«5) 
#define  KBKey  (1L«6) 
#define  KBAutoRepeatMode  (1L«7) 


/*  structure  for  ChangeKeyboardControl  */ 

typedef  struct  { 

int  key_click_percent; 
int  bell_percent ; 
int  bell_pitch; 
int  bell_duration; 
int  led; 
int  led_mode; 
int  key; 

int  auto_repeat_mode; 

}  XKeyboardControl; 

Errors 

BadMatch  values .  key  specified  but  values,  auto .  repeat  .mode  not  specified. 
val  ues .  led  specified  but  val  ues .  led_mode  not  specified. 

BadValue  values.  key_click_jper cent  <  -1. 

values. bell_percent  <  -1. 
values. bell_pitch  <  -1. 
values. bell_durat ion  <  -1. 

Related  Commands 

XAutoRepeatOf  f ,  XAutoRepeatOn,  XBell,  XGetDef  ault,  XGetKeyboard- 
Control, XGetPointerControl. 


/*  LedModeOn  or  LedModeOff  */ 

/*  AutoRepeatModeOf f ,  AutoRepeatModeOn, 
AutoRepeatModeDefault  */ 
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Name 

XChangeKeyboardMapping  —  change  the  keyboard  mapping. 

Synopsis 

XChangeKeyboardMapping  ( display,  first_code,  keysyms _jper_code, 
keysyms,  num_codes ) 

Display  *display ; 

int  first_keycode ; 

int  keysyms _jper_keycode  ; 

KeySym  * keysyms ; 
int  num_key codes ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
first_keycode 

Specifies  the  first  keycode  that  is  to  be  changed. 
keysyms _per_keycode 

Specifies  the  number  of  keysyms  that  the  caller  is  supplying  for  each  keycode. 
keysyms  Specifies  a  pointer  to  the  list  of  keysyms. 
num_key codes 

Specifies  the  number  of  keycodes  that  are  to  be  changed. 

Description 

Starting  with  first_keycode ,  XChangeKeyboardMapping  defines  the  keysyms  for  the 
specified  number  of  keycodes.  The  symbols  for  keycodes  outside  this  range  remain  unchanged. 
The  number  of  elements  in  the  keysyms  list  must  be  a  multiple  of  keysyms_per_keycode 
(else  a  BadLength  error).  The  specified  first_keycode  must  be  greater  than  or  equal  to 
min_keycode  supplied  at  connection  setup  and  stored  in  the  display  structure  (else  a  Bad- 
Value  error).  In  addition,  the  following  expression  must  be  less  than  or  equal  to  max_key- 
code  field  of  the  Display  structure  (else  a  BadValue  error): 

max_keycode  >=  first_keycode  +  ( num_keycodes  /  key symsper  key code)  -  1 

The  keysym  number  N  (counting  from  0)  for  keycode  K  has  an  index  in  the  keysyms  array 
(counting  from  0)  of  the  following  (in  keysyms): 

index  =  (K  -  first_keycode)  *  keysyms_per_keycode  +  N 

The  specified  key syms_jper_key code  can  be  chosen  arbitrarily  by  the  client  to  be  large 
enough  to  hold  all  desired  symbols.  A  special  keysym  value  of  NoSymbol  should  be  used  to 
fill  in  unused  elements  for  individual  keycodes.  It  is  legal  for  NoSymbol  to  appear  in  nontrail¬ 
ing  positions  of  the  effective  list  for  a  keycode. 

XChangeKeyboardMapping  generates  a  MappingNotif  y  event,  sent  to  this  and  all  other 
clients,  since  the  keycode  to  keysym  mapping  is  global  to  all  clients. 
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Errors 

BadAlloc 

BadValue  first .  key  code  less  than  display->  min_keycode. 

displ  ay->max_keycode  exceeded  (see  above). 

Related  Commands 

XDeleteModif  iermapEntry,  XFreeModif  iermap,  XGetKeyboardMapping, 
XGetModif  ierMapping,  XInsertModif  iermapEntry,  XKeycodeToKeysym, 
XKeysymToKeycode,  XKeysymToString,  XLookupKeysym,  XLookupString, 
XNewModif  ierMap,  XQueryKeymap,  XRebindKeySym,  XRef  reshKeyboard- 
Mapping,  XSetModif ierMapping, XStringToKeysym. 
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/ 


Name 

XChangePointerControl  —  change  the  pointer  preferences. 

Synopsis 

XChangePointerControl (  display,  do_accel ,  do_threshold, 
accel_numerator ,  accel_denominator ,  threshold) 

Display  ^display ; 

Bool  do_accel ,  do_threshold ; 

int  accel_numerator ,  accel_denominator ; 

int  threshold ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

do_accel  Specifies  a  boolean  value  that  controls  whether  the  values  for  the 

accel_numerator  or  accel_denominator  are  set.  You  can  pass  one 
of  these  constants:  True  or  False. 

do_threshold 

Specifies  a  boolean  value  that  controls  whether  the  value  for  the  threshold  is 
set.  You  can  pass  one  of  these  constants:  True  or  False. 

accel_numerator 

Specifies  the  numerator  for  the  acceleration  multiplier, 
a  ccel_den ominat or 

Specifies  the  denominator  for  the  acceleration  multiplier. 
threshold  Specifies  the  acceleration  threshold. 

Description 

XChangePointerControl  defines  how  the  pointing  device  functions.  The  acceleration  is 
a  fraction  ( accel_numerator/accel_denominator )  which  specifies  how  many  times 
faster  than  normal  the  sprite  on  the  screen  moves  for  a  given  pointer  movement.  Acceleration 
takes  effect  only  when  a  particular  pointer  motion  is  greater  than  threshold  pixels  at  once, 
and  only  applies  to  the  motion  beyond  threshold  pixels.  The  values  for  do_accel  and 
do_threshold  must  be  nonzero  for  the  pointer  values  to  be  set;  otherwise,  the  parameters 
will  be  unchanged.  Setting  any  of  the  last  three  arguments  to  -1  restores  the  default  for  that 
argument. 

The  fraction  may  be  rounded  arbitrarily  by  the  server. 

Errors 

BadValue  accel_denominator  is  0. 

Negative  value  for  do_accel  or  do_threshold. 
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Related  Commands 

XChangeActivePointerGrab, XGetPointerControl,  XGetPointerMapping, 
XGrabPointer, XQueryPointer,  XSetPointerMapping,  XUngrabPointer, 
XWarpPointer. 
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Name 

XChangeProperty  —  change  a  property  associated  with  a  window. 

Synopsis 

XChangeProperty ( displ ay,  w,  property,  type,  format,  mode, 
data,  nelements) 

Display  * display ; 

Window  w; 

Atom  property ,  type; 
int  format ; 
int  mode ; 

unsigned  char  *data; 
int  nelements ; 

Arguments 

displ ay 
w 

property 
type 

format 


mode 

data 

nelements 

Description 

XChangeProperty  changes  a  property  and  generates  PropertyNotify  events  if  they 
have  been  selected. 

XChangeProperty  does  the  following  according  to  the  mode  argument: 

•  PropModeReplace 

Discards  the  previous  property  value  and  stores  the  new  data. 

•  PropModeP repend 

Inserts  the  data  before  the  beginning  of  the  existing  data.  If  the  property  is  undefined,  it 
is  treated  as  defined  with  the  correct  type  and  format  with  zero-length  data,  type  and 
format  arguments  must  match  the  existing  property  value;  otherwise  a  BadMatch 
error  occurs. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
Specifies  the  ID  of  the  window  whose  property  you  want  to  change. 

Specifies  the  property  atom. 

Specifies  the  type  of  the  property.  X  does  not  interpret  the  type,  but  simply 
passes  it  back  to  an  application  that  later  calls  XGet Property. 

Specifies  whether  the  data  should  be  viewed  as  a  list  of  8-bit,  16-bit,  or  32-bit 
quantities.  This  information  allows  the  X  server  to  correctly  perform  byte- 
swap  operations  as  necessary.  If  the  format  is  16-bit  or  32-bit,  you  must 
explicitly  cast  your  data  pointer  to  a  ( char  *)  in  the  call  to  XChange¬ 
Property.  Possible  values  are  8, 16,  and  32. 

Specifies  the  mode  of  the  operation.  Possible  values  are  PropMode¬ 
Replace,  PropModeP  repend,  PropMode Append,  or  no  value. 

Specifies  the  property  data. 

Specifies  the  number  of  elements  in  the  property. 
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(continued) 


Xlib  -  Properties 


•  PropMode Append 

Appends  the  data  onto  the  end  of  the  existing  data.  If  the  property  is  undefined,  it  is 
treated  as  defined  with  the  correct  type  and  format  with  zero-length  data,  type  and 
format  arguments  must  match  the  existing  property  value;  otherwise  a  BadMatch 
error  occurs. 

The  property  may  remain  defined  even  after  the  client  which  defined  it  exits.  The  property 
becomes  undefined  only  if  the  application  calls  XDe let eP  rope  rty,  destroys  the  specified 
window,  or  closes  the  last  connection  to  the  X  server. 

The  maximum  size  of  a  property  is  server-dependent  and  can  vary  dynamically  if  the  server  has 
insufficient  memory. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Errors 

BadAlloc 

BadAtom 

BadMatch 

BadValue 

BadWindow 

Related  Commands 

XDeleteProperty,  XGetAtomName,  XGetFontProperty,  XGetWindowProperty, 
XInternAtom,  XListProperties, XRotateWindowProperties, XSetStandard- 
Properties. 
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XChangeSaveSet 


/ 


Name 

XChangeSaveSet  —  add  or  remove  a  subwindow  from  the  client’s  save-set. 

Synopsis 

XChangeSaveSet  ( display,  w,  change_mode) 

Display  ^display ; 

Window  w ; 

int  change_mode ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

w  Specifies  the  ID  of  the  window  whose  children  you  want  to  add  or  remove 

from  the  client’s  save-set;  it  must  have  been  created  by  some  other  client. 

change_mode  Specifies  the  mode.  Pass  one  of  these  constants:  SetMode Insert  (adds 
the  window  to  this  client’s  save-set)  or  SetModeDelete  (deletes  the  win¬ 
dow  from  this  client’s  save-set). 

Description 

XChangeSaveSet  adds  or  deletes  windows  from  a  client’s  save-set.  This  client  is  usually 
the  window  manager. 

The  save-set  of  the  window  manager  is  a  list  of  other  client’s  top-level  windows  which  have 
been  reparented.  If  the  window  manager  dies  unexpectedly,  these  top-level  application  win¬ 
dows  are  children  of  a  window  manager  window  and  therefore  would  normally  be  destroyed. 
The  save-set  prevents  this  by  automatically  reparenting  the  windows  listed  in  the  save-set  to 
their  closest  existing  ancestor,  and  then  remapping  them. 

Windows  are  removed  automatically  from  the  save-set  by  the  server  when  they  are  destroyed. 

For  more  information  on  save-sets,  see  Volume  One,  Chapter  13,  Other  Programming  Tech¬ 
niques . 

Errors 

BadMatch  w  not  created  by  some  other  client. 

BadValue 

BadWindow 

Related  Commands 

XAddToSaveSet, XRemoveFromSaveSet. 
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Xlib  -  Window  Attributes— 


XChangeWindowAttributes 


Name 

XChangeWindowAttributes  —  set  window  attributes. 

Synopsis 

XChangeWindowAttributes ( display,  w,  valuemask,  attributes) 
Display  * display ; 

Window  w ; 

unsigned  long  valuemask ; 

XSetWindowAt tributes  * attributes ; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  window  ID. 


valuemask  Specifies  which  window  attributes  are  defined  in  the  attributes  argu¬ 
ment  The  mask  is  made  by  combining  the  appropriate  mask  symbols  listed 
in  the  Structures  section  using  bitwise  OR  (|).  If  valuemask  is  zero,  the 
rest  is  ignored,  and  attributes  is  not  referenced.  The  values  and  restric¬ 
tions  are  the  same  as  for  XCreateWindow. 


attributes  Window  attributes  to  be  changed.  The  valuemask  indicates  which  mem¬ 
bers  in  this  structure  are  referenced. 


Description 

XChangeWindowAttributes  changes  any  or  all  of  the  window  attributes  that  can  be 
changed.  For  descriptions  of  the  window  attributes,  see  Volume  One,  Chapter  4,  Window  Attri¬ 
butes. 


Changing  the  background  does  not  cause  the  window  contents  to  be  changed  immediately-not 
until  the  next  Expose  event  or  XClearWindow  call.  Drawing  into  the  pixmap  that  was  set 
as  the  background  pixmap  attribute  has  an  undefined  effect  on  the  window  background.  The 
server  may  or  may  not  make  a  copy  of  the  pixmap.  Setting  the  border  causes  the  border  to  be 
repainted  immediately.  Changing  the  background  of  a  root  window  to  None  or  Parent - 
Relative  restores  the  default  background  pixmap.  Changing  the  border  of  a  root  window  to 
CopyFromParent  restores  the  default  border  pixmap. 

Changing  the  win_gravity  does  not  affect  the  current  position  of  the  window.  Changing 
the  backing_store  of  an  obscured  window  to  WhenMapped  or  Always  may  have  no 
immediate  effect.  Also  changing  the  backing_planes,  backing_pixel,  or 
save_under  of  a  mapped  window  may  have  no  immediate  effect. 

Multiple  clients  can  select  input  on  the  same  window;  the  event_mask  attributes  passed  are 
disjoint.  When  an  event  is  generated  it  will  be  reported  to  all  interested  clients.  Therefore,  the 
setting  of  the  event_mask  attribute  by  one  client  will  not  affect  the  event_mask  of  others 
on  the  same  window.  However,  at  most,  one  client  at  a  time  can  select  each  of 
SubstructureRedirectMask,  ResizeRedirectMask,  and  ButtonPressMask  on 
any  one  window.  If  a  client  attempts  to  select  on  SubtructureRedirectMask,  Resize- 
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(continued) 


XChangeWindowAttributes 


RedirectMask,  or  ButtonPressMask  and  some  other  client  has  already  selected  it  on  the 
same  window,  the  X  server  generates  a  BadAccess  error. 

There  is  only  one  do_not_propagate_mask  for  a  window,  not  one  per  client. 

Changing  the  colormap  attribute  of  a  window  generates  a  ColormapNotify  event.  Chang¬ 
ing  the  colormap  attribute  of  a  visible  window  may  have  no  immediate  effect  on  the  screen 
(because  the  colormap  may  not  be  installed  until  the  window  manager  calls  Xlnstall- 
Colormap). 

Changing  the  cursor  of  a  root  window  to  None  restores  the  default  cursor. 

For  more  information,  see  Volume  One,  Chapter  2,  X  Concepts ,  and  Chapter  4,  Window  Attri¬ 
butes. 


Structures 

/* 

*  Data  structure  for  setting  window 
*/ 

typedef  struct  { 

Pixmap  background_pixmap; 
unsigned  long  background_pixel; 
Pixmap  border_pixmap; 
unsigned  long  border_pixel; 
int  bit_gravity; 
int  win_gravity; 
int  backing_store; 
unsigned  long  backing_planes; 
unsigned  long  backing_pixel ; 
Bool  save_under; 
long  event_mask; 
long  do_not_propagate_mask; 

Bool  override_redirect; 

Colormap  colormap; 

Cursor  cursor; 

}  XSetWindowAttributes; 

/*  Definitions  for  valuemask  argumen 


attributes . 


/*  pixmap.  None,  or  ParentRelat ive  */ 

/*  background  pixel  */ 

/*  pixmap.  None,  or  CopyFromParent  */ 

/*  border  pixel  value  */ 

/*  one  of  bit  gravity  values  */ 

/*  one  of  the  window  gravity  values  */ 

/*  NotUseful,  WhenMapped,  Always  */ 

/*  planes  to  be  preseved  if  possible  */ 

/*  value  to  use  in  restoring  planes  */ 

/*  should  bits  under  be  saved  (popups)  */ 

/*  set  of  events  that  should  be  saved  */ 

/*  set  of  events  that  should  not  propagate  */ 
/*  override  redirected  config  request  */ 

/*  colormap  to  be  associated  with  window  */ 

/*  cursor  to  be  displayed  (or  None)  */ 


of  CreateWindow  and  ChangeWindowAtt ributes  */ 


tdefine 

CWBackPixmap 

(1L«0) 

tdefine 

CWBackPixel 

(1L«1 ) 

# define 

CWBorderPixmap 

(1L«2) 

tdefine 

CWBorderPixel 

(1L«3) 

tdefine 

CWBitGravity 

(1L«4 ) 

tdefine 

CWWinGravity 

(1L«5) 

tdefine 

CWBackingStore 

(1L«6) 

tdefine 

CWBackingPlanes 

(1L«7) 

tdefine 

CWBackingPixel 

(1L«8) 

tdefine 

CWOver rideRedi rect 

(1L«9) 

tdefine 

CWSaveUnder 

(1L«10) 

tdefine 

CWEventMask 

(1L«11) 

tdefine 

CWDont Propagate 

(1L«12) 

tdefine 

CWColormap 

(1L«13) 

tdefine 

CWCursor 

(1L«14) 
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Xlib  -  Window  Attributes 


Errors 

BadAccess 

BadColormap 

BadCursor 

BadMatch 

BadPixmap 

BadValue 

BadWindow 


Related  Commands 

XGetGeometry,  XGetWindowAttributes,  XSetWindowBackground, XSet- 
WindowBackgroundPixmap, XSetWindowBorder,  XSetWindowBorderPixmap. 
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XChecklfEvent 


/ 


Name 

XChecklfEvent  —  check  the  event  queue  for  a  matching  event. 


Synopsis 

Bool  XChecklfEvent ( display,  event,  predicate,  arg) 
Display  ^display ; 

XEvent  *  event;  /*  RETURN  */ 

Bool  (* predicate ) () ; 
char  *arg; 


Arguments 

displ ay 

event 

predicate 

arg 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Returns  the  matched  event 

Specifies  the  procedure  that  is  called  to  determine  if  the  next  event  matches 
your  criteria. 

Specifies  the  user-specified  argument  that  will  be  passed  to  the  predicate  pro¬ 
cedure. 


Description 

XChecklfEvent  returns  the  next  event  in  the  queue  that  is  matched  by  the  specified  predi¬ 
cate  procedure.  If  found,  that  event  is  removed  from  the  queue,  and  True  is  returned.  If  no 
match  is  found,  XChecklfEvent  returns  False  and  flushes  the  request  buffer.  No  other 
events  are  removed  from  the  queue.  Later  events  in  the  queue  are  not  searched. 

The  predicate  procedure  is  called  with  the  arguments  display,  event,  and  arg. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 


Related  Commands 

QLength, XAllowEvents, XCheckMaskEvent, XCheckTypedEvent, XCheck- 
TypedWindowEvent,  XCheckWindowEvent, XEvent sQueued, XGet InputFocus, 
XGetMotionEvents, XlfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent,  XPending,  XPutBackEvent,  XSelectlnput,  XSendEvent,  XSetlnput- 
Focus,  XSynchronize, XWindowEvent. 
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Xlib  -  Input  Handling  — 


\ 


Name 

XCheckMaskEvent  —  remove  the  next  event  that  matches  mask;  don’t  wait. 


Synopsis 

Bool  XCheckMaskEvent ( display,  event_mask,  event) 
Display  ^display ; 
long  event_mask ; 

XEvent  *  event;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

event_mask  Specifies  the  event  types  to  be  returned.  See  list  under  XSelect Input. 
event  Returns  a  copy  of  the  matched  event’s  XEvent  structure. 

Description 

XCheckMaskEvent  removes  the  next  event  in  the  queue  that  matches  the  passed  mask.  The 
event  is  copied  into  an  XEvent  supplied  by  the  caller  and  XCheckMaskEvent  returns 
True.  Other  events  earlier  in  the  queue  are  not  discarded.  If  no  such  event  has  been  queued, 
XCheckMaskEvent  flushes  the  request  buffer  and  immediately  returns  False,  without  wait¬ 
ing. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 


Related  Commands 

QLength,  XAllowEvents,  XChecklfEvent,  XCheckTypedEvent, XCheckTyped- 
WindowEvent, XCheckWindowEvent, XEvent sQueued,  XGet InputFocus, XGet- 
MotionEvents, XlfEvent,  XMaskEvent, XNextEvent,  XPeekEvent, XPeek- 
IfEvent,  XPending,  XPutBackEvent, XSelectlnput, XSendEvent, XSetlnput- 
Focus, XSynchronize,  XWindowEvent. 
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XCheckTypedEvent 


/ 


Name 

XCheckTypedEvent  —  return  the  next  event  in  queue  that  matches  event  type;  don’t  wait. 


Synopsis 

Bool  XCheckTypedEvent ( display,  event_type,  report) 
Display  *display ; 
int  event_type; 

XEvent  *  report;  /*  RETURN  */ 


Arguments 

di  spl  ay 

event_type 

report 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  event  type  to  be  compared. 

Returns  a  copy  of  the  matched  event  structure. 


Description 

XCheckTypedEvent  searches  first  the  event  queue,  then  the  events  available  on  the  server 
connection,  for  the  specified  even t_ type.  If  there  is  a  match,  it  returns  the  associated  event 
structure.  Events  searched  but  not  matched  are  not  discarded.  XCheckTypedEvent  returns 
True  if  the  event  is  found.  If  the  event  is  not  found,  XCheckTypedEvent  flushes  the 
request  buffer  and  returns  False. 

This  command  is  similar  to  XCheckMaskEvent,  but  it  searches  through  the  queue  instead  of 
inspecting  only  the  last  item  on  the  queue.  It  also  matches  only  a  single  event  type  instead  of 
multiple  event  types  as  specified  by  a  mask. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 


Related  Commands 

QLength,  XAllowEvents, XChecklfEvent, XCheckMaskEvent, XCheckTyped- 
WindowEvent, XCheckWindowEvent, XEvent sQueued, XGet InputFocus, XGet- 
MotionEvents, XlfEvent, XMaskEvent, XNextEvent,  XPeekEvent, XPeek- 
IfEvent,  XPending,  XPutBackEvent, XSelectlnput,  XSendEvent, XSetlnput- 
Focus, XSynchronize, XWindowEvent. 


Xlib  Reference  Manual 


79 


XCheckTypedWindowEvent  \_ 


Xlib  -  Input  Handling- 


Name 

XCheckTypedWindowEvent  —  return  the  next  event  in  queue  matching  type  and  window. 


Synopsis 

Bool  XCheckTypedWindowEvent  ( display,  w,  event_type,  report) 
Display  ^display ; 

Window  w; 

int  event_type; 

XEvent  *  report;  /*  RETURN  */ 


Arguments 

di  spl  ay 
w 

event_type 

report 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  window  ID. 

Specifies  the  event  type  to  be  compared. 

Returns  the  matched  event’s  associated  structure  into  this  client-supplied 
structure. 


Description 

XCheckTypedWindowEvent  searches  first  the  event  queue,  then  any  events  available  on 
the  server  connection,  for  an  event  that  matches  the  specified  window  and  the  specified  event 
type.  Events  searched  but  not  matched  are  not  discarded. 

XCheckTypedWindowEvent  returns  True  if  the  event  is  found;  it  flushes  the  request  buffer 
and  returns  False  if  the  event  is  not  found. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 

Related  Commands 

QLength, XAllowEvents, XChecklf Event, XCheckMaskEvent, XCheckTyped- 
Event, XCheckWindowEvent, XEventsQueued, XGet InputFocus,  XGetMotion- 
Events, XlfEvent,  XMaskEvent, XNextEvent,  XPeekEvent,  XPeeklf Event, 
XPending,  XPutBackEvent, XSelectlnput, XSendEvent,  XSetlnputFocus, 
XSynchronize, XWindowEvent. 
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XCheckWindowEvent 


/ 


Name 

XCheckWindowEvent  —  remove  the  next  event  matching  both  passed  window  and  passed 
mask;  don’t  wait. 


Synopsis 

Bool  XCheckWindowEvent ( display,  w,  event_mask,  event) 
Display  ^display ; 

Window  w; 

long  event_mask ; 

XEvent  *event;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window  ID.  The  event  must  match  both  the  passed  window  and 

the  passed  event  mask. 

event_mask  Specifies  the  event  mask.  See  XSelect  Input  for  a  list  of  mask  elements. 
event  Returns  the  XEvent  structure. 

Description 

XCheckWindowEvent  removes  the  next  event  in  the  queue  that  matches  both  the  passed 
window  and  the  passed  mask.  If  such  an  event  exists,  it  is  copied  into  an  XEvent  supplied  by 
the  caller.  Other  events  earlier  in  the  queue  are  not  discarded. 

If  a  matching  event  is  found,  XCheckWindowEvent  returns  True.  If  no  such  event  has  been 
queued,  it  flushes  the  request  buffer  and  returns  False,  without  waiting. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 


Related  Commands 

QLength, XAllowEvents, XChecklfEvent,  XCheckMaskEvent,  XCheckTyped- 
Event,  XCheckTypedWindowEvent,  XEvent sQueued,  XGet  InputFocus,  XGet- 
MotionEvents, XlfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent,  XSelectlnput, XSendEvent, XSetlnput- 
Focus, XSynchronize, XWindowEvent. 


Xlib  Reference  Manual 


81 


XCirculateSubwindows 


Xlib  -  Window  Manipulation  — 


\ 


Name 

XCirculateSubwindows  —  circulate  the  stacking  order  of  children  up  or  down. 

Synopsis 

XCirculateSubwindows ( display,  wr  direction) 

Display  * display ; 

Window  w; 
int  di  recti  on ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window  ID  of  the  parent  of  the  subwindows  to  be  circulated. 

direction  Specifies  the  direction  (up  or  down)  that  you  want  to  circulate  the  children. 
Pass  either  RaiseLowest  or  LowerHighest. 

Description 

XCirculateSubwindows  circulates  the  children  of  the  specified  window  in  the  specified 
direction,  either  RaiseLowest  or  LowerHighest.  If  some  other  client  has  selected 
SubstructureRedirectMask  on  the  specified  window,  then  a  CirculateRequest 
event  is  generated,  and  no  further  processing  is  performed.  If  you  specify  RaiseLowest,  this 
function  raises  the  lowest  mapped  child  (if  any)  that  is  occluded  by  another  child  to  the  top  of 
the  stack.  If  you  specify  LowerHighest,  this  function  lowers  the  highest  mapped  child  (if 
any)  that  occludes  another  child  to  the  bottom  of  the  stack.  Exposure  processing  is  performed 
on  formerly  obscured  windows. 

For  more  information,  see  Volume  One,  Chapter  14,  Window  Management. 

Errors 

BadValue 

BadWindow 

Related  Commands 

XCirculateSubwindowsDown, XCirculateSubwindowsUp,  XConf igureWindow, 
XLowerWindow,  XMoveResizeWindow,  XMoveWindow,  XQueryTree,  XRaise- 
Window,  XReparentWindow,  XResizeWindow,  XRestackWindows. 
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XCirculateSubwindowsDown 


Name 

XCirculateSubwindowsDown  —  circulate  the  bottom  child  to  the  top  of  the  stacking  order. 

Synopsis 

XCirculateSubwindowsDown  (  display ,  w) 

Display  ^display ; 

Window  w; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

w  Specifies  the  window  ID  of  the  parent  of  the  windows  to  be  circulated. 

Description 

XCirculateSubwindowsDown  lowers  the  highest  mapped  child  of  the  specified  window 
that  partially  or  completely  obscures  another  child.  The  lowered  child  goes  to  the  bottom  of  the 
stack.  Completely  unobscured  children  are  not  affected. 

This  function  generates  exposure  events  on  any  window  formerly  obscured.  Repeated  execu¬ 
tions  lead  to  round-robin  lowering.  This  is  equivalent  to  XCirculateSubwindows  (dis¬ 
play,  w,  LowerHighest). 

If  some  other  client  has  selected  SubstructureRedirectMask  on  the  window,  then  a 
CirculateRequest  event  is  generated,  and  no  further  processing  is  performed.  This  allows 
the  window  manager  to  intercept  this  request  when  w  is  the  root  window.  Usually,  only  the 
window  manager  will  call  this  on  the  root  window. 

For  more  information,  see  Volume  One,  Chapter  14,  Window  Management. 

Errors 

BadWindow 

Related  Commands 

XCirculateSubwindows, XCirculateSubwindowsUp,  XConf igureWindow, 
XLowerWindow,  XMoveResizeWindow,  XMoveWindow,  XQueryTree,  XRaise- 
Window,  XReparentWindow,  XResizeWindow,  XRestackWindows. 
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Xlib  -  Window  Manipulation- 


Name 

XCirculateSubwindowsUp  —  circulate  the  top  child  to  the  bottom  of  the  stacking  order. 

Synopsis 

XCirculateSubwindowsUp ( display ,  w) 

Display  * display ; 

Window  w; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window  ID  of  the  parent  of  the  windows  to  be  circulated. 

Description 

XCirculateSubwindowsUp  raises  the  lowest  mapped  child  of  the  specified  window  that  is 
partially  or  completely  obscured  by  another  child.  The  raised  child  goes  to  the  top  of  the  stack. 
Completely  unobscured  children  are  not  affected.  This  generates  exposure  events  on  the  raised 
child  (and  its  descendents,  if  any).  Repeated  executions  lead  to  round  robin-raising.  This  is 
equivalent  to  XCirculateSubwindows  ( display ,  w,  RaiseLowest). 

If  some  other  client  has  selected  SubstructureRedirectMask  on  the  window,  then  a 
CirculateRequest  event  is  generated,  and  no  further  processing  is  performed.  This  allows 
the  window  manager  to  intercept  this  request  when  w  is  the  root  window.  Usually,  only  the 
window  manager  will  call  this  on  the  root  window. 

For  more  information,  see  Volume  One,  Chapter  14,  Window  Management. 

Errors 

BadWindow 

Related  Commands 

XCirculateSubwindows, XCirculateSubwindowsDown,  XConf igureWindow, 
XLowerWindow,  XMoveResizeWindow,  XMoveWindow,  XQueryTree,  XRaise- 
Window,  XReparentWindow,  XResizeWindow,  XRestackWindows. 
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— Xlib  -  Drawing  Primitives 


XClearArea 


/ 


Name 

XClearArea  —  clear  a  rectangular  area  in  a  window. 

Synopsis 

XClearArea ( display,  w,  x,  y,  width ,  height,  exposures) 
Display  ^display ; 

Window  w ; 
int  x,  y; 

unsigned  int  width,  height ; 

Bool  exposures ; 

Arguments 

di  spl  ay 

w 
x 

y 

width 
height 


Description 

XClearArea  clears  a  rectangular  area  in  a  window. 

If  width  is  zero,  the  window  is  cleared  from  x  to  the  right  edge  of  the  window.  If  height  is 
zero,  the  window  is  cleared  from  y  to  the  bottom  of  the  window.  See  figure  above.. 

If  the  window  has  a  defined  background  tile  or  it  is  ParentRelative,  the  rectangle  is  tiled 
with  a  plane_mask  of  all  l’s,  a  function  of  GXcopy,  and  a  subwindow_mode  of 
ClipBy Children.  If  the  window  has  background  None,  the  contents  of  the  window  are  not 
changed.  In  either  case,  if  exposures  is  True,  then  one  or  more  exposure  events  are  gen¬ 
erated  for  regions  of  the  rectangle  that  are  either  visible  or  are  being  retained  in  a  backing  store. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Specifies  the  ID  of  an  inputOutput  window. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle  to  be 
cleared,  relative  to  the  origin  of  the  window. 

Specify  the  dimensions  in  pixels  of  the  rectangle  to  be  cleared. 

Specifies  whether  exposure  events  are  generated.  Must  be  either  True  or 
False. 
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XClearArea 


(continued) 


Xlib  -  Drawing  Primitives 


Window 


Window 


Window 


Errors 

BadMatch  Window  is  an  Input  Only  class  window. 

BadValue 

BadWindow 

Related  Commands 

XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc,  XDrawArcs,  XDraw- 
Filled,  XDrawLine,  XDrawLines,  XDrawPoint,  XDrawPoints,  XDrawRectangle, 
XDrawRect angles, XDrawSegments, XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle, XFillRectangles. 
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—  Xlib  -  Drawing  Primitives 


XClearWindow 


/ 


Name 

XClearWindow  —  clear  an  entire  window. 

Synopsis 

XClearWindow (display,  w ) 

Display  *  display ; 

Window  w; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  ID  of  the  window  to  be  cleared. 

Description 

XClearWindow  clears  a  window,  but  does  not  cause  exposure  events.  This  function  is  equiv¬ 
alent  to  XClearArea  ( display,  w,  0,  0,  0,  0,  False). 

If  the  window  has  a  defined  background  tile  or  it  is  ParentRelative,  the  rectangle  is  tiled 
with  a  plane_mask  of  all  l’s  and  function  of  GXcopy.  If  the  window  has  background 
None,  the  contents  of  the  window  are  not  changed. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadMatch  If  w  is  an  inputOnly  class  window. 

BadValue 

BadWindow 

Related  Commands 

XClearArea,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc,  XDrawArcs,  XDraw- 
Filled,  XDrawLine, XDrawLines, XDrawPoint,  XDrawPoints,  XDrawRectangle, 
XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle, XFillRectangles. 
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XClipBox 


Xlib  -  Regions — 


\ 


Name 

XClipBox  —  generate  the  smallest  rectangle  enclosing  a  region. 

Synopsis 

XClipBox  (r,  rect) 

Region  r; 

XRectangle  *rect ;  /*  RETURN  */ 

Arguments 

r  Specifies  the  region. 

rect  Returns  the  smallest  rectangle  enclosing  region  r. 

Description 

XClipBox  returns  the  smallest  rectangle  that  encloses  the  given  region. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

Region  is  a  pointer  to  an  opaque  structure  type. 

Related  Commands 

XCreateRegion,  XDestroyRegion, XEmptyRegion,  XEqualRegion, 
XIntersectRegion, XOf f setRegion,  XPoint InRegion,  XPolygonRegion, 
XRectlnRegion,  XSetRegion,  XShrinkRegion,  XSubtractRegion, XUnion- 
RectWithRegion, XUnionRegion,  XXorRegion. 
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—  Xlib  -  HouseKeeping 


XCIoseDisplay 


/ 


Name 

XCIoseDisplay  —  disconnect  a  client  program  from  an  X  server  and  display. 

Synopsis 

XCIoseDisplay  ( display ) 

Display  * display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

Description 

XCIoseDisplay  closes  the  connection  between  the  current  client  and  the  X  server  specified 
by  the  Display  argument. 

The  XCIoseDisplay  routine  destroys  all  windows,  resource  IDs  (Window,  Font,  Pixmap, 
Colormap,  Cursor,  and  GContext),  or  other  resources  (GCs)  that  the  client  application 
has  created  on  this  display,  unless  the  close  down  mode  of  the  client’s  resources  has  been 
changed  by  XSetCloseDownMode.  Therefore,  these  windows,  resource  IDs,  and  other 
resources  should  not  be  referenced  again.  In  addition,  this  routine  discards  any  requests  that 
have  been  buffered  but  not  yet  sent  to  the  server. 

Although  these  operations  automatically  (implicitly)  occur  when  a  process  exits  under  UNIX, 
you  should  call  XCIoseDisplay  anyway. 

For  more  information,  see  Volume  One,  Chapter  3 ,  Basic  Window  Program. 

Related  Commands 

Def  aultScreen,  XFree,  XNoOp,  XOpenDisplay. 
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XConfigureWindow 


Xlib  -  Window  Manipulation  — 


\ 


Name 

XConfigureWindow  —  change  the  window  position,  size,  border  width,  or  stacking  order. 

Synopsis 

XConf igureWindow ( display,  w,  value_mask,  values) 

Display  * display ; 

Window  w; 

unsigned  int  value_mask ; 

XWindowChanges  * values; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  ID  of  the  window  to  be  reconfigured. 

value_mask  Specifies  which  values  are  to  be  set  using  information  in  the  values  struc¬ 
ture.  val  ue_mask  is  the  bitwise  OR  of  any  number  of  symbols  listed  in  the 
Structures  section  below. 

values  Specifies  a  pointer  to  the  XWindowChanges  structure  containing  new  confi¬ 

guration  information.  See  the  Structures  section  below. 

Description 

XConfigureWindow  changes  the  window  position,  size,  border  width,  and/or  the  stacking 
order.  If  selected,  a  Conf  igureNotify  event  is  generated  to  announce  any  changes. 

If  the  window  to  be  reconfigured  is  a  top-level  window,  there  will  be  interaction  with  the  win¬ 
dow  manager  if  the  override_redirect  attribute  of  the  window  is  False.  In  this  case, 
the  X  server  sends  a  Conf  igureRequest  event  to  the  window  manager  and  does  not  recon¬ 
figure  the  window.  The  window  manager  receives  this  event  and  then  makes  the  decision 
whether  to  allow  the  application  to  reconfigure  its  window.  The  client  should  wait  for  the 
Conf  igureNotify  event  to  find  out  the  size  and  position  of  the  window. 

In  Release  4,  XReconf igureWMWindow  should  be  used  instead  of  XConfigureWindow 
for  top-level  windows.  This  routine  handles  restacking  of  top-level  windows  properly. 

If  a  window’s  size  actually  changes,  the  window’s  subwindows  may  move  according  to  their 
window  gravity.  If  they  do,  GravityNotify  events  will  be  generated  for  them.  Depending 
on  the  window’s  bit  gravity,  the  contents  of  the  window  also  may  be  moved.  See  Volume  One, 
Chapter  4,  Window  Attributes  for  further  information. 

Exposure  processing  is  performed  on  formerly  obscured  windows,  including  the  window  itself 
and  its  inferiors,  if  regions  of  them  were  obscured  but  afterward  are  not.  As  a  result  of  increas¬ 
ing  the  width  or  height,  exposure  processing  is  also  performed  on  any  new  regions  of  the  win¬ 
dow  and  any  regions  where  window  contents  are  lost. 

The  members  of  XWindowChanges  that  you  specify  in  values  arc: 
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Xlib-  Window  Manipulation  (continued)  XConflgureWindOW 


X 

y 

width 

Specify  the  x  and  y  coordinates  of  the  upper-left  outer  comer  of  the  window 
relative  to  the  parent’s  origin. 

Specify  the  inside  size  of  the  window  in  pixels,  not  including  the  border. 

height  These  arguments  must  be  positive. 

border_wi  dth 

Specifies  the  width  of  the  border  in  pixels. 


sibling 

Specifies  the  sibling  window  for  stacking  operations.  If  not  specified,  no 
change  in  the  stacking  order  will  be  made.  If  specified,  stack_mode  must 
also  be  specified. 

stack_mode 

The  stack  mode  can  be  any  of  these  constants:  Above,  Below,  Toplf, 

Bottomlf ,  or  Opposite. 

The  computation  for  the  Bottomlf,  Toplf,  and  Opposite  stacking  modes  is  performed 
with  respect  to  window  w’s  final  size  and  position  (as  controlled  by  the  other  arguments  to 
XConf  igurewindow,  not  its  initial  position.)  It  is  an  error  if  sibling  is  specified  without 
stack_mode.  If  sibling  and  stack_mode  are  specified,  the  window  is  restacked  as  fol- 


lows: 

Stacking  Rag 

Position 

Above 

wis  placed  just  above  sibling 

Below 

w  is  placed  just  below  sibling 

Toplf 

if  sibling  obscures  w,  then  w  is  placed  at  the  top 
of  the  stack 

Bottomlf 

if  w  obscures  sibling ,  then  w  is  placed  at  the  bot¬ 
tom  of  the  stack 

Opposite 

if  sibling  occludes  w,  then  w  is  placed  at  the  top 
of  the  stack.  If  w  occludes  sibling ,  then  w  is 
placed  at  the  bottom  of  the  stack.  If  wand  sibling 
do  not  overlap,  no  change  is  made. 
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XConfigureWindow 


(continued) 


Xlib  -  Window  Manipulation 


If  a  stack_mode  is  specified  but  no  sibling  is  specified,  the  window  is  restacked  as  follows: 


Stacking  Flag 

Position 

Above 

w  is  placed  at  the  top  of  the  stack 

Below 

w  is  placed  at  the  bottom  of  the  stack 

Toplf 

if  any  sibling  obscures  w,  then  w  is  placed  at  the  top 
of  the  stack 

Bottomlf 

if  w  obscures  any  sibling,  then  window  is  placed  at 
the  bottom  of  the  stack 

Opposite 

if  any  sibling  occludes  w,  then  w  is  placed  at  the  top 
of  the  stack,  else  if  w  occludes  any  sibling,  then  w  is 
placed  at  the  bottom  of  the  stack 

Under  Release  4,  use  XReconf  igureWMWindow  to  configure  a  top-level  window. 

Structures 

typedef  struct  { 
int  x,  y; 

int  width,  height; 
int  border_width; 

Window  sibling; 
int  stack_mode; 

}  XWindowChanges; 

/*  Conf igureWindow  structure  */ 

/*  ChangeWindow  value  bits  definitions  for  valuemask  */ 


#def ine  CWX  <  1«0 ) 
#def ine  CWY  (1«1) 
#def ine  CWWidth  (1«2) 
#def ine  CWHeight  (1«3) 
#define  CWBorderWidth  (1«4) 
#define  CWSibling  (1«5) 
♦  define  CWStackMode  ( 1 <<6 ) 


Errors 

BadMatch  Attempt  to  set  any  invalid  attribute  of  inputOnly  window. 
sibling  specified  without  a  stack_mode. 

The  sibling  window  is  not  actually  a  sibling. 

BadValue  width  or  height  is  0. 

BadWindow 
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Xlib  -  Window  Manipulation 


(continued) 


XConflgureWindow 


Related  Commands 

XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp,  XLowerWindow,  XMoveResizeWindow,  XMoveWindow,  XQuery- 
Tree,  XReconf  igureWMWindow,  XRaiseWindow,  XRepa  rent  Window,  XResize- 
Window, XRestackWindows. 
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XConvertSelection 


Xlib  -  Selections — 


\ 


Name 

XConvertSelection  —  use  the  value  of  a  selection. 

Synopsis 

XConvertSelection ( display,  selection ,  target,  property, 
requestor ,  time) 

Display  ^display ; 

Atom  selection ,  target ; 

Atom  property ;  /*  may  be  None  */ 

Window  requestor ; 

Time  time ; 

Arguments 

di  spl  ay 
selection 

target 

property 


requestor 
time 

Description 

XConvertSelection  causes  a  SelectionRequest  event  to  be  sent  to  the  current  selec¬ 
tion  owner  if  there  is  one,  specifying  the  property  to  store  the  data  in  ( selection ),  the  format 
to  convert  that  data  into  before  storing  it  (target),  the  property  to  place  the  information  in 
(property),  the  window  that  wants  the  information  (requestor),  and  the  time  to  make  the 
conversion  (time). 

The  selection  owner  responds  by  sending  a  Select ionNot if y  event,  which  confirms  the 
selected  atom  and  type.  If  no  owner  for  the  specified  selection  exists,  or  if  the  owner  could  not 
convert  to  the  type  specified  by  requestor,  the  X  server  generates  or  the  owner  sends  a 
Select  ionNot  if  y  event  to  the  requestor  with  property  None.  Whether  or  not  the  owner 
exists,  the  arguments  are  passed  unchanged.  See  Volume  One,  Chapter  \0,  Inter  client  Commu¬ 
nication,  for  a  description  of  selection  events  and  selection  conventions. 

Errors 

BacLAtom 

BadWindow 

Related  Commands 

XGet Select ionOwner, XSet Select ionOwner. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Specifies  the  selection  atom.  xa_primary  and  xa_secondary  are  the  stan¬ 
dard  selection  atoms. 

Specifies  the  atom  of  the  type  property  that  specifies  the  desired  format  for 
the  data. 

Specifies  the  property  in  which  the  requested  data  is  to  be  placed.  None  is 
also  valid,  but  current  conventions  specify  that  the  requestor  is  in  a  better 
position  to  select  a  property  than  the  selection  owner. 

Specifies  the  requesting  window. 

Specifies  the  time  when  the  conversion  should  take  place.  Pass  either  a 
timestamp,  expressed  in  milliseconds,  or  the  constant  CurrentTime. 
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—  Xlib  -  Drawing  Primitives 


XCopyArea 


/ 


Name 

XCopyArea  —  copy  an  area  of  a  drawable. 

Synopsis 

XCopyArea  ( display,  src,  dest ,  gc ,  src_x,  src_yr  width, 
height,  des  t_x ,  dest_y) 

Display  * display ; 

Drawable  src,  dest ; 

GC  gc; 

int  src_x,  src_y; 
unsigned  int  width,  height; 
int  dest_x,  dest_y; 

Arguments 

displ ay 

src 
dest 

gc 

src_x 
src_y 

width 
height 

dest_x 
dest_y 

Description 

XCopyArea  combines  the  specified  rectangle  of  src  with  the  specified  rectangle  of  dest. 
src  and  dest  must  have  the  same  root  and  depth. 

If  regions  of  the  source  rectangle  are  obscured  and  have  not  been  retained  in  back- 
ing_store,  or  if  regions  outside  the  boundaries  of  the  source  drawable  are  specified,  then 
those  regions  are  not  copied.  Instead,  the  following  occurs  on  all  corresponding  destination 
regions  that  are  either  visible  or  are  retained  in  backing_store.  If  dest  is  a  window  with 
a  background  other  than  None,  the  corresponding  regions  of  the  destination  are  tiled  (with 
plane_mask  of  all  l’s  and  function  GXcopy)  with  that  background.  Regardless  of  tiling,  if 
the  destination  is  a  window  and  graphics_exposures  in  gc  is  True,  then  Graphics- 
Expose  events  for  all  corresponding  destination  regions  are  generated.  If  graph - 
ics_exposures  is  True  but  no  regions  are  exposed,  then  a  NoExpose  event  is  generated. 

If  regions  of  the  source  rectangle  are  not  obscured  and  graphics_exposures  is  False, 
one  NoExpose  event  is  generated  on  the  destination. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Specify  the  source  and  destination  rectangles  to  be  combined,  src  and 
dest  must  have  the  same  root  and  depth. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  source  rectan¬ 
gle  relative  to  the  origin  of  the  source  drawable. 

Specify  the  dimensions  in  pixels  of  both  the  source  and  destination  rectan¬ 
gles. 

Specify  the  x  and  y  coordinates  within  the  destination  window. 
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XCopyArea 


(continued) 


Xlib  -  Drawing  Primitives 


XCopyArea  uses  these  graphics  context  components:  function,  plane_mask, 
subwindow_mode,  graphics_exposures,  clip_x_origin,  clip  y  origin,  and 
clip_mask. 

Errors 

BadDrawable 

BadGC 

BadMatch  The  src  and  dest  rectangles  do  not  have  the  same  root  and  depth. 

Related  Commands 

XClearArea,  XClearWindow,  XCopyPlane,  XDraw,  XDrawArc,  XDrawArcs, 
XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs,  XFill- 
Polygon, XFillRectangle,  XFillRectangles. 
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—  Xlib-Colormaps 


XCopyColormapAndFree 


/ 


Name 

XCopyColormapAndFree  —  copy  a  colormap  and  return  a  new  colormap  ID. 

Synopsis 

Colormap  XCopyColormapAndFree  (  display,  cmap) 

Display  *  display ; 

Colormap  cmap; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

cmap  Specifies  the  colormap  you  are  moving  out  of. 

Description 

XCopyColormapAndFree  is  used  to  obtain  a  new  virtual  colormap  when  allocating  color- 
cells  out  of  a  previous  colormap  has  failed  due  to  resource  exhaustion  (that  is,  too  many  cells  or 
planes  were  in  use  in  the  original  colormap). 

XCopyColormapAndFree  moves  all  of  the  client’s  existing  allocations  from  cmap  to  the 
returned  Colormap  and  frees  those  entries  in  cmap.  The  visual  type  and  screen  for  the  new 
colormap  is  the  same  as  for  the  old. 

If  cmap  was  created  by  the  client  with  the  alloc  argument  set  to  AllocAll,  the  new  color- 
map  is  also  created  with  AllocAll,  all  color  values  for  all  entries  are  copied  from  cmap,  and 
then  all  entries  in  cmap  are  freed. 

If  cmap  was  created  by  the  client  with  AllocNone,  the  allocations  to  be  moved  are  all  those 
pixels  and  planes  that  have  been  allocated  by  the  client  using  XAllocColor,  XAlloc- 
NamedColor,  XAllocColorCells,  or  XAllocColorPlanes  and  that  have  not  been 
freed  since  they  were  allocated.  Values  in  other  entries  of  the  new  Colormap  are  undefined. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadAlloc 

BadColormap 

Related  Commands 

Def  aultColormap,  DisplayCells,  XCreateColormap,  XFreeColormap,  XGet- 
StandardColormap, XInstallColormap,  XListlnstalledColormaps, XSet- 
StandardColormap, XSetWindowColormap, XUninstallColormap. 
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XCopyGC 


Xlib  -  Graphics  Context— 


\ 


Name 

XCopyGC  —  copy  a  graphics  context. 

Synopsis 

XCopyGC  (display,  src,  valuemask ,  dest) 
Display  ^display ; 

GC  src,  dest; 
unsigned  long  valuemask ; 


Arguments 

displ ay 
src 

valuemask 


dest 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  components  of  the  source  graphics  context. 

Specifies  the  components  in  the  source  GC  structure  to  be  copied  into  the  des¬ 
tination  GC.  valuemask  is  made  by  combining  any  number  of  the  mask 
symbols  listed  in  the  Structures  section  using  bitwise  OR  (|). 

Specifies  the  destination  graphics  context. 


Description 

XCopyGC  copies  the  selected  elements  of  one  graphics  context  to  another.  See  Volume  One, 
Chapter  5,  The  Graphics  Context ,  for  a  description  of  the  graphics  context. 


Structures 

The  GC  structure  contains  the  following  elements: 


/* 

*  Data  structure  for  setting  graphics  context. 
*/ 


typedef  struct  { 
int  function; 
unsigned  long  plane_mask; 
unsigned  long  foreground; 
unsigned  long  background; 
int  line_width; 
int  line_style; 
int  cap_style; 
int  join_style; 
int  fill_style; 
int  fill_rule; 
int  arc_mode; 

Pixmap  tile; 

Pixmap  stipple; 
int  ts_x_origin; 
int  ts_y_origin; 

Font  font; 

int  subwindow_mode; 

Bool  graphics_exposures; 
int  clip_x_origin; 


/*  logical  operation  */ 

/*  plane  mask  */ 

/*  foreground  pixel  */ 

/*  background  pixel  */ 

/*  line  width  */ 

/*  Solid,  OnOffDash,  DoubleDash  */ 

/*  NotLast,  Butt,  Round,  Projecting  */ 

/*  Miter,  Round,  Bevel  */ 

/*  Solid,  Tiled,  Stippled  */ 

/*  EvenOdd,  Winding  */ 

/*  PieSlice  */ 

/*  tile  pixmap  for  tiling  operations  */ 

/*  stipple  1  plane  pixmap  for  stipping  */ 

/*  offset  for  tile  or  stipple  operations  */ 

/*  default  text  font  for  text  operations  */ 
/*  ClipByChildren,  Includelnferiors  */ 

/*  boolean,  should  exposures  be  generated  */ 
/*  origin  for  clipping  */ 
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int  clip_y_origin; 
Pixmap  clip_mask; 
int  dash_offset; 
char  dashes; 


/*  bitmap  clipping;  other  calls  for  rects  */ 
/*  patterned/dashed  line  information  */ 


}  XGCValues; 

#def ine 

GCFunction 

(1L«0) 

#def ine 

GCPlaneMask 

(1L«1) 

#def ine 

GCForeground 

(1L«2) 

#def ine 

GCBackground 

(1L«3) 

#def ine 

GCLineWidth 

(1L«4) 

#def ine 

GCLineStyle 

( 1L«5 ) 

#def ine 

GCCapStyle 

( 1L«6) 

#def ine 

GCJoinStyle 

(1L«7) 

#def ine 

GCFillStyle 

( 1L«8 ) 

#def ine 

GCFillRule 

(1L«9) 

#def ine 

GCTile 

( 1L«10) 

#def ine 

GCStipple 

(1L«11) 

#def ine 

GCTileStipXOrigin 

(1L«12) 

#def ine 

GCTileStipYOrigin 

(1L«13) 

#def ine 

GCFont 

( 1L«14 ) 

#def ine 

GCSubwindowMode 

(1L«15) 

#def ine 

GCGraphicsExposures 

( 1L«16) 

#def ine 

GCClipXOrigin 

( 1L«17) 

#def ine 

GCClipYOrigin 

(1L«18) 

#def ine 

GCClipMask 

(1L«19) 

#def ine 

GCDashOf fset 

(1L«20) 

#def ine 

GCDashList 

( 1L«21 ) 

#def ine 

GCArcMode 

( 1L«22) 

Errors 

BadAlloc 

BadGC 

BadMatch 


src  and  dest  do  not  have  the  same  root  and  depth. 


Related  Commands 

Def  aultGC,  XChangeGC,  XCreateGC,  XFreeGC,  XGContextFromGC,  XGet- 
GCValues, XSetArcMode, XSetBackground,  XSetClipMask,  XSetClipOrigin, 
XSetClipRectangles, XSetDashes,  XSetFillRule,  XSetFillStyle,  XSet- 
Foreground,  XSetFunction,  XSetGraphicsExposures,  XSetLineAttributes, 
XSetPlaneMask, XSetState,  XSetStipple,  XSetSubwindowMode, XSet- 
TSOrigin. 
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\ 


Name 


XCopyPlane  — 

copy  a  single  plane  of  a  drawable  into  a  drawable  with  depth,  applying  pixel 
values. 

Synopsis 

XCopyPlane ( display,  src ,  dest,  gc ,  src_x,  src_y,  width, 
height,  dest_x,  dest_y,  plane) 

Display  * display ; 

Drawable  src,  dest; 

GC  gc; 

int  src_x,  src_y ; 
unsigned  int  width,  height; 
int  des t_x,  dest  y; 
unsigned  long  plane; 

Arguments 

displ  ay 

Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

src 

dest 

Specify  the  source  and  destination  drawables. 

gc 

Specifies  the  graphics  context. 

src_x 

src_y 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  source  rectan¬ 
gle  relative  to  the  origin  of  the  drawable. 

width 

height 

Specify  the  width  and  height  in  pixels.  These  are  the  dimensions  of  both  the 
source  and  destination  rectangles. 

dest_x 

dest_y 

Specify  the  x  and  y  coordinates  at  which  the  copied  area  will  be  placed  rela¬ 
tive  to  the  origin  of  the  destination  drawable. 

plane 

Specifies  the  source  bit-plane.  You  must  set  exactly  one  bit,  and  the  bit  must 
specify  a  plane  that  exists  in  src. 

Description 

XCopyPlane  copies  a  single  plane  of  a  rectangle  in  the  source  into  the  entire  depth  of  a  corre¬ 
sponding  rectangle  in  the  destination.  The  plane  of  the  source  drawable  and  the  fore¬ 
ground/background  pixel  values  in  gc  are  combined  to  form  a  pixmap  of  the  same  depth 
as  the  destination  drawable,  and  the  equivalent  of  an  xCopyArea  is  performed,  with  all  the 
same  exposure  semantics. 

XCopyPlane  uses  these  graphics  context  components:  function,  plane_mask, 
foreground,  background,  subwindow_mode,  graphics_exposures, 
clip_x_origin,  clip_y_origin,  and  clip_mask. 

The  src  and  dest  drawables  must  have  the  same  root,  but  need  not  have  the  same  depth. 

For  more  information,  see  Volume  One,  Chapter  5,  The  Graphics  Context. 
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Errors 

BadDrawable 

BadGC 

BadMatch  src  and  dest  do  not  have  the  same  root. 

BadValue  plane  does  not  have  exactly  one  bit  set,  or  bit  specified  in  plane  is  not  a 
plane  in  src. 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XDraw,  XDrawArc,  XDrawArcs,  XDraw- 
Filled, XDrawLine, XDrawLines,  XDrawPoint,  XDrawPoints,  XDrawRectangle, 
XDrawRectangles,  XDrawSegments,  XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle,  XFillRectangles. 
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\ 


Name 

XCreateAssocTable  —  create  a  new  association  table  (X10). 

Synopsis 

XAssocTable  *XCreateAssocTable (size) 
int  size; 

Arguments 

si  ze  Specifies  the  number  of  buckets  in  the  hashed  association  table. 

Description 

XCreateAssocTable  creates  an  association  table,  which  allows  you  to  associate  your  own 
structures  with  X  resources  in  a  fast  lookup  table.  This  function  is  provided  for  compatibility 
with  X  Version  10.  To  use  it  you  must  include  the  file  <X11/X10.h>  and  link  with  the  library 
-loldX. 

The  size  argument  specifies  the  number  of  buckets  in  the  hash  system  of  XAssocTable. 
For  reasons  of  efficiency  the  number  of  buckets  should  be  a  power  of  two.  Some  size  sugges¬ 
tions  might  be:  use  32  buckets  per  100  objects;  a  reasonable  maximum  number  of  object  per 
buckets  is  8. 

If  there  is  an  error  allocating  memory  for  the  XAssocTable,  a  null  pointer  is  returned. 

For  more  information  on  association  tables,  see  Volume  One,  Appendix  B,  X10  Compatibility. 

Structures 

typedef  struct  { 

XAssoc  *buckets; 
int  size; 

}  XAssocTable; 

Related  Commands 

XDeleteAssoc, XDestroyAssocTable, XLookUpAssoc,  XMakeAssoc. 


/*  pointer  to  first  bucket  in  array  */ 
/*  table  size  (number  of  buckets)  */ 
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XCreateBitmapFromData 


/ 


Name 

XCreateBitmapFromData  —  create  a  bitmap  from  xil  bitmap  format  data. 

Synopsis 

Pixmap  XCreateBitmapFromData  (  display,  drawable ,  data, 
width,  height) 

Display  *  display ; 

Drawable  drawable ; 
char  *data; 

unsigned  int  width,  height; 

Arguments 

displ  ay 
drawable 
data 

width 
height 

Description 

XCreateBitmapFromData  creates  a  single-plane  pixmap  from  an  array  of  hexadecimal 
data.  This  data  may  be  defined  in  the  program  or  included.  The  bitmap  data  must  be  in  X  ver¬ 
sion  11  format  as  shown  below  (it  cannot  be  in  X10  format).  The  following  format  is  assumed 
for  the  data,  where  the  variables  are  members  of  the  ximage  structure  described  in  Volume 
One,  Chapter  6,  Drawing  Graphics  and  Text : 

f ormat=XYP ixmap 

bit_order=LSBFirst 

byte_order=LSBFirst 

bitmap_unit=8 

bitmap_pad=8 

xof f set=0 

no  extra  bytes  per  line 

XCreateBitmapFromData  creates  an  image  with  the  specified  data  and  copies  it  into  the 
created  pixmap.  The  following  is  an  example  of  creating  a  bitmap: 

#define  gray_width  16 
tdefine  gray_height  16 
#define  gray_x_hot  8 
tdefine  gray_y_hot  8 
static  char  gray_bits[]  =  { 

Oxf 8 ,  Oxl f,  0xe3f  0xc7 ,  Oxcf,  0xf3,  0x9f,  0xf9, 

Oxbf ,  Oxfd,  0x33,  Oxcc,  0x7f,  Oxfe,  0x7f,  Oxfe, 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
Specifies  a  drawable.  This  determines  which  screen  to  create  the  bitmap  on. 
Specifies  the  bitmap  data,  in  XI 1  bitmap  file  format. 

Specify  the  dimensions  in  pixels  of  the  created  bitmap.  If  smaller  than  the 
bitmap  data,  the  upper-left  comer  of  the  data  is  used. 
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0x7e,  0x7e,  0x7f,  Oxfe,  0x37,  Oxec,  Oxbb,  Oxdd, 

0x9c,  0x39,  Oxcf,  0xf3,  0xe3,  0xc7,  0xf8,  Oxlf}; 

Pixmap  XCreateBitmapFromData (display,  window,  gray_bits, 
gray_width,  gray_height) ; 

If  the  call  could  not  create  a  pixmap  of  the  requested  size  on  the  server,  XCreateBitmap¬ 
FromData  returns  0  (zero),  and  the  server  generates  a  BadAlloc  error.  If  the  requested 
depth  is  not  supported  on  the  screen  of  the  specified  drawable,  the  server  generates  a  Bad- 
Match  error. 

The  user  should  free  the  bitmap  using  XFreePixmap  when  it  is  no  longer  needed. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadAlloc  Server  has  insufficient  memory  to  create  bitmap. 

BadDrawable 

BadValue  Specified  bitmap  dimensions  are  zero. 

Related  Commands 

XCreatePixmap,  XCreatePixmapFromBitmapData,  XCreatePixmapFrom- 
BitmapData, XFreePixmap, XQueryBestSize,  XQueryBestStipple, XQuery- 
BestTile, XReadBitmapFile, XSetTile,  XSetWindowBackgroundPixmap, 
XSetWindowBorderPixmap,  XWriteBitmapFile. 
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/ 


Name 

XCreateColormap  —  create  a  colormap. 

Synopsis 

Colormap  XCreateColormap  ( display,  w,  visual ,  alloc) 

Display  ^display ; 

Window  w; 

Visual  * visual ; 
int  alloc; 

Arguments 

display 
w 

visual 

alloc 

Description 

XCreateColormap  creates  a  colormap  of  the  specified  visual  type  and  allocates  either  none 
or  all  of  its  entries,  and  returns  the  colormap  ID. 

It  is  legal  to  specify  any  visual  class  in  the  structure  pointed  to  by  the  visual  argument.  If  the 
class  is  StaticColor,  StaticGray,  or  TrueColor,  the  colorcells  will  have  pre-allocated 
read-only  values  defined  by  the  individual  server  but  unspecified  by  the  XI 1  protocol.  In  these 
cases,  alloc  must  be  specified  as  AllocNone  (else  a  BadMatch  error). 

For  the  other  visual  classes,  Pseudocolor,  DirectColor,  and  Grayscale,  you  can  pass 
either  AllocAll  or  AllocNone  to  the  alloc  argument.  If  you  pass  AllocNone,  the 
colormap  has  no  allocated  entries.  This  allows  your  client  programs  to  allocate  read-only 
colorcells  with  XAllocColor  or  read/write  cells  with  XAllocColorCells,  Alloc- 
ColorP lanes  and  XStoreColors.  If  you  pass  the  constant  AllocAll,  the  entire  color- 
map  is  allocated  writable  (all  the  entries  are  read/write,  nonshareable  and  have  undefined  initial 
RGB  values),  and  the  colors  can  be  set  with  XStoreColors.  However,  you  cannot  free  these 
entries  with  XFreeColors,  and  no  relationships  between  the  entries  are  defined. 

If  the  visual  class  is  Pseudocolor  or  Grayscale  and  alloc  is  AllocAll,  this  function 
simulates  a  call  to  the  function  XAllocColor  cells  returning  all  pixel  values  from  1  to 
(map_entries  -  1 ) .  For  a  visual  class  of  DirectColor,  the  processing  for  AllocAll 
simulates  a  call  to  the  function  XAllocColorPlanes,  returning  a  pixel  value  of  0  and  mask 
values  the  same  as  the  red_mask,  green_mask,  and  blue_mask  members  in  visual. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Specifies  a  window  ID.  The  colormap  created  will  be  associated  with  the 
same  screen  as  the  window. 

Specifies  a  pointer  to  the  visual  structure  for  the  colormap.  The  visual 
class  and  depth  must  be  supported  by  the  screen. 

Specifies  how  many  colormap  entries  to  allocate.  Pass  either  AllocNone  or 
AllocAll. 
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(continued) 


Xlib  -  Colormaps 


The  visual  argument  should  be  as  returned  from  the  Defaultvisual  macro,  XMatch- 
Visuallnf  o,  or  XGetVisuallnf  o. 

If  the  hardware  colormap  on  the  server  is  immutable,  and  therefore  there  is  no  possibility  that  a 
virtual  colormap  could  ever  be  installed,  XCreateColormap  returns  the  default  colormap. 
Code  should  check  the  returned  ID  against  the  default  colormap  to  catch  this  situation. 

For  more  information  on  creating  colormaps,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadAlloc 

BadMatch  Didn’t  use  AllocNone  for  StaticColor,  StaticGray,  or  True- 
Color. 

visual  type  not  supported  on  screen. 

BadValue 

BadWindow 

Related  Commands 

Def aultColormap, DisplayCells, XCopyColormapAndFree,  XFreeColormap, 
XGetStandardColormap, XInstallColormap,  XListlnstalledColormaps, 
XSetStandardColormap, XSetWindowColormap,  XUninstallColormap. 
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—  Xlib  -  Cursors 


/ 


Name 

XCreateFontCursor  —  create  a  cursor  from  the  standard  cursor  font. 

Synopsis 

#include  <Xll/cursorf ont . h> 

Cursor  XCreateFontCursor (  display,  shape) 

Display  ^display ; 
unsigned  int  shape; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

shape  Specifies  which  character  in  the  standard  cursor  font  should  be  used  for  the  cur¬ 
sor. 

Description 

X  provides  a  set  of  standard  cursor  shapes  in  a  special  font  named  “cursor.”  Programs  are 
encouraged  to  use  this  interface  for  their  cursors,  since  the  font  can  be  customized  for  the  indi¬ 
vidual  display  type  and  shared  between  clients. 

The  hotspot  comes  from  the  information  stored  in  the  font.  The  initial  colors  of  the  cursor  are 
black  for  the  foreground  and  white  for  the  background.  XRecolorCursor  can  be 
used  to  change  the  colors  of  the  cursor  to  those  desired. 

For  more  information  about  cursors  and  their  shapes  in  fonts,  see  Appendix  I,  The  Cursor  Font. 
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(continued) 


Xlib  -  Cursors 


Errors 

BadAlloc 

BadFont 

BadValue  The  shape  argument  does  not  specify  a  character  in  the  standard  cursor  font. 

Related  Commands 

XCreateGlyphCursor, XCreatePixmapCursor, XDef ineCursor,  XFreeCursor, 
XQueryBestCursor, XQueryBestSize, XRecolorCursor,  XUndef ineCursor. 


108 


Xlib  Reference  Manual 


—  Xlib  -  Graphics  Context 


XCreateGC 


/ 


Name 

XCreateGC  —  create  a  new  graphics  context  for  a  given  screen  with  the  depth  of  the  specified 
drawable. 

Synopsis 

GC  XCreateGC  ( display,  drawable,  valuemask,  values) 

Display  ^display ; 

Drawable  drawable ; 
unsigned  long  valuemask ; 

XGCValues  *  values ; 


Arguments 

di  spl  ay 
drawable 

valuemask 

values 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Specifies  a  drawable.  The  created  GC  can  only  be  used  to  draw  in  drawables 
of  the  same  depth  as  this  drawable. 

Specifies  which  members  of  the  GC  are  to  be  set  using  information  in  the 
values  structure,  valuemask  is  made  by  combining  any  number  of  the 
mask  symbols  listed  in  the  Structures  section. 

Specifies  a  pointer  to  an  XGCValues  structure  which  will  provide  compo¬ 
nents  for  the  new  GC. 


Description 

XCreateGC  creates  a  new  graphics  context  resource  in  the  server.  The  returned  GC  can  be 
used  in  subsequent  drawing  requests,  but  only  on  drawables  on  the  same  screen  and  of  the  same 
depth  as  the  drawable  specified  in  the  drawable  argument. 


The  specified  components  of  the  new  graphics  context  in  valuemask  are  set  to  the  values 
passed  in  the  values  argument.  Unset  components  default  as  follows: 


Component 

Value 

plane_mask 

all  l’s 

foreground 

0 

background 

1 

line_width 

0 

line  style 

LineSolid 

cap_style 

CapButt 

join  style 

JoinMiter 

f ill_style 

FillSolid 

f ill_rule 

EvenOddRule 

arc  mode 

ArcPieSlice 

tile 

Pixmap  filled  with  foreground  pixel 

stipple 

Pixmap  filled  with  l’s 
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Component 

Value 

ts_x_origin 

0 

ts  y  origin 

0 

font 

(implementation  dependent) 

subwindow_mode 

ClipByChildren 

graphics_exposures 

True 

clip_x_origin 

0 

clip  y  origin 

0 

clip  mask 

None 

dash  offset 

0 

dash  list 

4  (i.e.,  the  list  [4, 4]) 

An  application  should  minimize  the  number  of  GCs  it  creates,  because  some  servers  cache  a 
limited  number  of  GCs  in  the  display  hardware,  and  can  attain  better  performance  with  a  small 
number  of  GCs. 

For  more  information,  see  Volume  One,  Chapter  5,  The  Graphics  Context. 


Errors 

BadAlloc  Server  could  not  allocate  memory  for  GC. 

BadDrawable  Specified  drawable  is  invalid. 

BadFont  Font  specified  for  font  component  of  GC  has  not  been  loaded. 

BadMatch  Pixmap  specified  for  tile  component  has  different  depth  or  is  on  different 
screen  from  the  specified  drawable.  Or  pixmap  specified  for  stipple  or 
clip_mask  component  has  depth  other  than  1. 

BadPixmap  Pixmap  specified  for  tile,  stipple ,  or  clip_mask  components  is  inva¬ 
lid. 


BadValue  Values  specified  for  function ,  line_style,  cap_style, 

join_style,  fill_style,  fill_rule,  subwindow_mode,  graph- 
ics_exposures,  dashes,  or  arc_mode  are  invalid,  or  invalid  mask 
specified  for  valuemask  argument. 


Structures 

typedef  struct  { 

int  function; 

unsigned  long  plane_mask; 

unsigned  long  foreground; 

unsigned  long  background; 

int  line_width; 

int  line_style; 

int  cap_style; 

int  join_style; 

int  fill_style; 

int  fill_rule; 


/*  logical  operation  */ 

/*  plane  mask  */ 

/*  foreground  pixel  */ 

/*  background  pixel  */ 

/*  line  width  */ 

/*  LineSolid,  LineOnOf fDash,  LineDoubleDash  */ 

/*  CapNotLast,  CapButt,  CapRound,  CapPro jecting  */ 
/*  JoinMiter,  JoinRound,  JoinBevel  */ 

/*  FillSolid,  FillTiled,  FillStippled  */ 

/*  EvenOddRule,  WindingRule  */ 
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int  arc_mode; 

/*  ArcPieSlice,  ArcChord  */ 

Pixmap  tile; 

/*  tile  pixmap  for  tiling  operations  */ 

Pixmap  stipple; 

/*  stipple  1  plane  pixmap  for  stipping  *, 

int  ts_x  origin; 

/*  offset  for  tile  or  stipple  operations 

int  ts_y_origin; 

Font  font; 

/*  default  text  font  for  text  operations 

int  subwindow  mode; 

/*  ClipByChildren,  Includelnferiors  */ 

Bool  graphics_exposures; 

/*  generate  events  on  XCopyArea,  XCopyPl; 

int  clip_x_origin; 

/*  origin  for  clipping  */ 

int  clip_y_origin; 

Pixmap  clip_mask; 

/*  bitmap  clipping;  other  calls  for  rect: 

int  dash_offset; 

/*  patterned/dashed  line  information  */ 

char  dashes; 

}  XGCValues; 

#define  GCFunction 

(1L«0) 

#define  GCPlaneMask 

(1L«1 ) 

#define  GCForeground 

(1L«2) 

#define  GCBackground 

(1L«3) 

#define  GCLineWidth 

(1L<<4 ) 

#define  GCLineStyle 

(1L«5) 

tdefine  GCCapStyle 

(1L«6) 

tdefine  GCJoinStyle 

(1L«7) 

#define  GCFillStyle 

(1L«8) 

tdefine  GCFillRule 

(1L«9) 

tdefine  GCTile 

(1L«10) 

tdefine  GCStipple 

(1L«11) 

tdefine  GCTileStipXOrigin 

(1L«12) 

tdefine  GCTileStipYOrigin 

(1L«13) 

tdefine  GCFont 

(1L«14) 

tdefine  GCSubwindowMode 

(1L«15) 

tdefine  GCGraphicsExposures 

(1L«16) 

tdefine  GCClipXOrigin 

(1L«17) 

tdefine  GCClipYOrigin 

(1L«18) 

tdefine  GCClipMask 

(1L«19) 

tdefine  GCDashOffset 

(1L«20) 

tdefine  GCDashList 

(1L«21) 

tdefine  GCArcMode 

(1L«22) 

Related  Commands 

Def  aultGC,  XChangeGC,  XCopyGC,  XFreeGC,  XGContextFromGC,  XGetGCValues, 
XSetArcMode, XSetBackground,  XSetClipMask,  XSetClipOrigin,  XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes,  XSetPlane- 
Mask, XSetState, XSetStipple,  XSetSubwindowMode,  XSetTSOrigin. 
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XCreateGlyphCursor 


Xlib  -  Cursors— 


\ 


Name 

XCreateGlyphCursor  —  create  a  cursor  from  font  glyphs. 

Synopsis 

Cursor  XCreateGlyphCursor (  display,  source_font,  mask_font , 
source_char ,  mask_char ,  foreground_color,  back- 
ground_color) 

Display  * display ; 

Font  source_font ,  mask_font ; 
unsigned  int  source_char ,  mask_char ; 

XColor  * foreground_color ; 

XColor  *background_color ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
source_font  Specifies  the  font  from  which  a  character  is  to  be  used  for  the  cursor. 
mask_font  Specifies  the  mask  font.  Optional;  specify  0  if  not  needed. 
source_char  Specifies  the  index  into  the  cursor  shape  font. 

mask_char  Specifies  the  index  into  the  mask  shape  font.  Optional;  specify  0  if  not 
needed. 

foreground_col or 

Specifies  the  red,  green,  and  blue  (RGB)  values  for  the  foreground. 
background_color 

Specifies  the  red,  green,  and  blue  (RGB)  values  for  the  background. 

Description 

XCreateGlyphCursor  is  similar  to  XCreatePixmapCursor,  but  the  source  and  mask 
bitmaps  are  obtained  from  separate  font  characters,  perhaps  in  separate  fonts.  The  mask  font 
and  character  are  optional.  If  mask_char  is  not  specified,  all  pixels  of  the  source  are 
displayed. 

The  x  offset  for  the  hotspot  of  the  created  cursor  is  the  left-bearing  for  the  source  character,  and 
the  y  offset  is  the  ascent,  each  measured  from  the  upper-left  comer  of  the  bounding  rectangle  of 
the  character. 

The  origins  of  the  source  and  mask  (if  it  is  defined)  characters  are  positioned  coincidently  and 
define  the  hotspot.  The  source  and  mask  need  not  have  the  same  bounding  box  metrics,  and 
there  is  no  restriction  on  the  placement  of  the  hotspot  relative  to  the  bounding  boxes. 

Note  that  source_char  and  mask_char  are  of  type  unsigned  int,  not  of  type 
XChar2b.  For  two-byte  matrix  fonts,  source_char  and  mask_char  should  be  formed 
with  the  by  tel  member  in  the  most  significant  byte  and  the  byte2  member  in  the  least  signif¬ 
icant  byte. 
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(continued) 


XCreateGlyphCursor 


You  can  free  the  fonts  with  XFreeFont  if  they  are  no  longer  needed  after  creating  the  glyph 
cursor. 

For  more  information  on  fonts  and  cursors,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and 
Text. 

Structures 

typedef  struct  { 

unsigned  long  pixel; 

unsigned  short  red,  green,  blue; 

char  flags;  /*  DoRed,  DoGreen,  DoBlue  */ 

char  pad; 

}  XColor; 

Errors 

BadAlloc 

BadFont 

BadValue  source_char  not  defined  in  source_font. 

mask_char  not  defined  in  mask_font  (if  mask_font  defined). 

Related  Commands 

XCreateFontCursor, XCreatePixmapCursor, XDef ineCursor,  XFreeCursor, 
XQueryBestCursor, XQueryBestSize,  XRecolorCursor,  XUndef ineCursor. 
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XCreatelmage 


Xlib  -  Images — 


\ 


Name 

XCreatelmage  —  allocate  memory  for  an  X Image  structure. 

Synopsis 

#include  <X11/Xutil . h> 

Xlmage  ^XCreatelmage ( display,  visual,  depth,  format,  offset, 
data,  width,  height,  bitmap_pad,  bytes _jper_line) 
Display  * display ; 

Visual  * visual; 
unsigned  int  depth; 
int  format ; 
int  offset ; 
char  *data; 
unsigned  int  width; 
unsigned  int  height; 


int 

bitmap  pad; 

int 

bytes _per_line; 

Arguments 

displ  ay 

Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

visual 

Specifies  a  pointer  to  a  visual  that  should  match  the  visual  of  the  window  the 
image  is  to  be  displayed  in. 

depth 

Specifies  the  depth  of  the  image. 

format 

Specifies  the  format  for  the  image.  Pass  one  of  these  constants:  XYPixmap, 
or  ZPixmap. 

offset 

Specifies  the  number  of  pixels  beyond  the  beginning  of  the  data  (pointed  to 
by  data)  where  the  image  actually  begins.  This  is  useful  if  the  image  is  not 
aligned  on  an  even  addressable  boundary. 

data 

Specifies  a  pointer  to  the  image  data. 

width 

height 

Specify  the  width  and  height  in  pixels  of  the  image. 

bi  tmap_pad  Specifies  the  quantum  of  a  scan  line.  In  other  words,  the  start  of  one  scan  line 
is  separated  in  client  memory  from  the  start  of  the  next  scan  line  by  an  integer 
multiple  of  this  many  bits.  You  must  pass  one  of  these  values:  8, 1 6,  or  32. 

bytes _jper_line 

Specifies  the  number  of  bytes  in  the  client  image  between  the  start  of  one 
scan  line  and  the  start  of  the  next.  If  you  pass  a  value  of  0  here,  Xlib  assumes 
that  the  scan  lines  are  contiguous  in  memory  and  thus  calculates  the  value  of 
bytes_per_line  itself. 
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(continued) 


XCreatelmage 


Description 

XCreatelmage  allocates  the  memory  needed  for  an  Xlmage  structure  for  the  specified  dis¬ 
play  and  visual. 

This  function  does  not  allocate  space  for  the  image  itself.  It  initializes  the  structure  with  byte 
order,  bit  order,  and  bitmap  unit  values,  and  returns  a  pointer  to  the  Xlmage  structure.  The  red, 
green,  and  blue  mask  values  are  defined  for  ZPixmap  format  images  only  and  are  derived  from 
the  Visual  structure  passed  in. 

For  a  description  of  images,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Related  Commands 

ImageByteOrder,  XAddPixel,  XDestroylmage,  XGetlmage,  XGetPixel,  XGet- 
Sublmage,  XPutlmage,  XPutPixel,  XSublmage. 
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XCreatePixmap 


Xlib  -  Pixmaps  and  Tiles— 


\ 


Name 

XCreatePixmap  —  create  a  pixmap. 

Synopsis 

Pixmap  XCreatePixmap ( display,  drawable,  width ,  height,  depth) 
Display  *  display ; 

Drawable  drawable ; 
unsigned  int  width,  height ; 
unsigned  int  depth; 

Arguments 

display 

drawable 

width 
height 

depth 

Description 

XCreatePixmap  creates  a  pixmap  resource  and  returns  its  pixmap  ID.  The  initial  contents 
of  the  pixmap  are  undefined. 

The  server  uses  the  drawable  argument  to  determine  which  screen  the  pixmap  is  stored  on. 
The  pixmap  can  only  be  used  on  this  screen.  The  pixmap  can  only  be  drawn  drawn  into  with 
GCs  of  the  same  depth,  and  can  only  be  copied  to  drawables  of  the  same  depth,  except  in 
XCopyPlane. 

A  bitmap  is  a  single-plane  pixmap.  There  is  no  separate  bitmap  type  in  X  Version  1 1 . 

Pixmaps  should  be  considered  a  precious  resource,  since  many  servers  have  limits  on  the 
amount  of  off-screen  memory  available. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadAlloc 

BadDrawable 

BadValue  width  or  height  is  0. 

depth  is  not  supported  on  screen. 

Related  Commands 

XCreateBitmapFromData, XCreatePixmapFromBitmapData, XFreePixmap, 
XListDepths,  XListPixmapFormat, XQueryBestCursor, XQueryBestSize, 
XQueryBestStipple, XQueryBestTile, XReadBitmapFile, XSetTile,  XSet- 
WindowBackgroundPixmap, XSetWindowBorderPixmap,  XWriteBitmapFile. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
Specifies  the  drawable.  May  be  an  Input  Only  window. 

Specify  the  width  and  height  in  pixels  of  the  pixmap.  The  values  must  be 
nonzero. 

Specifies  the  depth  of  the  pixmap.  The  depth  must  be  supported  by  the  screen 
of  the  specified  drawable.  (Use  XListDepths  if  in  doubt.) 


116 


Xlib  Reference  Manual 


—  Xlib  -  Pixmaps  and  Tiles 


XCreatePixmapCursor 


/ 


Name 

XCreatePixmapCursor  —  create  a  cursor  from  two  bitmaps. 

Synopsis 

Cursor  XCreatePixmapCursor ( display,  source,  mask, 

foreground_color,  background_color ,  x_hot ,  y_hot) 

Display  * display ; 

Pixmap  source ; 

Pixmap  mask; 

XColor  *foreground_color; 

XColor  * background_color ; 
unsigned  int  x_hot ,  y_hot; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDi splay. 
source  Specifies  the  shape  of  the  source  cursor.  A  pixmap  of  depth  1. 

mask  Specifies  the  bits  of  the  cursor  that  are  to  be  displayed  (the  mask  or  stipple). 

A  pixmap  of  depth  1 . 

foreground_col or 

Specifies  the  red,  green,  and  blue  (RGB)  values  for  the  foreground. 
background_color 

Specifies  the  red,  green,  and  blue  (RGB)  values  for  the  background. 

x_hot  Specify  the  coordinates  of  the  cursor’s  hotspot  relative  to  the  source’s  origin. 

y_hot  Must  be  a  point  within  the  source. 


Description 

XCreatePixmapCursor  creates  a  cursor  and  returns  a  cursor  ID.  Foreground  and  back¬ 
ground  RGB  values  must  be  specified  using  foreground_color  and  back- 
ground_colory  even  if  the  server  only  has  a  monochrome  screen.  The  fore- 
ground_color  is  used  for  the  1  bits  in  the  source,  and  the  background  is  used  for  the  0  bits. 
Both  source  and  mask  (if  specified)  must  have  depth  1,  but  can  have  any  root.  The  mask  pix¬ 
map  defines  the  shape  of  the  cursor;  that  is,  the  1  bits  in  the  mask  define  which  source  pixels 
will  be  displayed.  If  no  mask  is  given,  all  pixels  of  the  source  are  displayed.  The  mask,  if 
present,  must  be  the  same  size  as  the  source. 

The  pixmaps  can  be  freed  immediately  if  no  further  explicit  references  to  them  are  to  be  made. 
For  more  information  on  cursors,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

typedef  struct  { 

unsigned  long  pixel; 

unsigned  short  red,  green,  blue; 

char  flags;  /*  DoRed,  DoGreen,  DoBlue  */ 
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XCreatePixmapCursor 


(continued) 


Xlib  -  Pixmaps  and  Tiles 


char  pad; 

}  XColor; 

Errors 

BadAlloc 

BadMatch  Mask  bitmap  must  be  the  same  size  as  source  bitmap. 

BadPixmap 

Related  Commands 

XCreateBitmapFromData, XDef  ineCursor, XCreateFontCursor, XCreate- 
Pixmap,  XCreatePixmapCursor,  XFreeCursor,  XFreePixmap,  XQuery  Best- 
Cursor,  XQueryBestCursor, XQuery BestSize, XQueryBestSize,  XRead- 
BitmapFile, XRecolorCursor, XUndef ineCursor. 
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XCreatePixmapFromBitmapData 


Name 

XCreatePixmapFromBitmapData  —  create  a  pixmap  with  depth  from  bitmap  data. 

Synopsis 

Pixmap  XCreatePixmapFromBitmapData  ( display,  drawable,  data, 
width,  height,  fg,  bg,  depth) 

Display  * display ; 

Drawable  drawable ; 
char  *data; 

unsigned  int  width,  height; 
unsigned  long  fg,  bg; 
unsigned  int  depth; 

Arguments 

display 
drawable 

data 

width 
height 

fg 

bg 

depth 

Description 

XCreatePixmapFromBitmapData  creates  a  pixmap  of  the  given  depth  using  bitmap  data 
and  foreground  and  background  pixel  values. 

The  following  format  for  the  data  is  assigned,  where  the  variables  are  members  of  the  X Image 
structure  described  in  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text : 

f ormat=XYP ixmap 

bit_order=LSBFirst 

byte_order=LSBFirst 

bitmap_unit=8 

bitmap_pad=8 

xof f set=0 

no  extra  bytes  per  line 

XCreatePixmapFromBitmapData  creates  an  image  from  the  data  and  uses  XPutlmage 
to  place  the  data  into  the  pixmap.  For  example: 


Specifies  a  connection  to  an  Display  structure,  returned  from  XOpen- 
Display. 

Specifies  a  drawable  ID  which  indicates  which  screen  the  pixmap  is  to  be 
used  on. 

Specifies  the  data  in  bitmap  format. 

Specify  the  width  and  height  in  pixels  of  the  pixmap  to  create. 

Specify  the  foreground  and  background  pixel  values  to  use. 

Specifies  the  depth  of  the  pixmap.  Must  be  valid  on  the  screen  specified  by 
drawable. 
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XCreatePixmapFromBitmapData  (continued) 


Xlib  -  Pixmaps  and  Bitmaps 


tdefine  gray_width  16 
#define  gray_height  16 
#define  gray_x_hot  8 
#define  gray_y_hot  8 
static  char  gray_bits [ ]  =  { 


0xf8, 

Oxlf 

,  0xe3, 

0xc7( 

r  Oxcf,  0xf3, 

0x9f , 

Oxf 9,  Oxbf 

Oxfd, 

0x33 

,  Oxcc, 

0x7f, 

,  Oxfe,  0x7f, 

Oxfe, 

0x7e,  0x7e 

0x7f , 

Oxfe 

,  0x37, 

Oxec, 

,  Oxbb,  Oxdd, 

0x9c, 

0x39,  Oxcf 

0xf3, 

0xe3 

,  0xc7, 

Oxf  8, 

r  Oxlf); 

unsigned 

long 

foreground,  background; 

unsigned  int  depth; 

/*  open  display,  determine  colors  and  depth  */ 

Pixmap  XCreatePixmapFromBitmapData (display,  window,  gray_bits, 

gray_width,  gray_height,  foreground,  background,  depth) ; 

If  you  want  to  use  data  of  a  different  format,  it  is  straightforward  to  write  a  routine  that  does 
this  yourself,  using  images. 

Pixmaps  should  be  considered  a  precious  resource,  since  many  servers  have  limits  on  the 
amount  of  off-screen  memory  available. 

Errors 

BadAlloc 

BadDrawable 

BadValue  The  width  or  height  of  pixmap  are  zero,  or  depth  is  not  a  valid  depth  on 
the  screen  specified  by  drawable. 

Related  Commands 

XCreateBitmapFromData, XCreateFontCursor, XCreatePixmap, XCreate- 
PixmapCursor, XDef ineCursor, XFreeCursor,  XFreePixmap,  XListPixmap- 
Formats,  XQueryBestCursor, XQueryBestSize,  XReadBitmapFile,  XRecolor- 
Cursor,  XUndef  ineCursor. 
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XCreateRegion 


/ 


Name 

XCreateRegion  —  create  a  new  empty  region. 

Synopsis 

Region  XCreateRegion  ( ) 

Description 

XCreateRegion  creates  a  new  region  of  undefined  size.  XPolygonRegion  can  be  used  to 
create  a  region  with  a  defined  shape  and  size.  Many  of  the  functions  that  perform  operations  on 
regions  can  also  create  regions. 

For  a  description  of  regions,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

Region  is  a  pointer  to  an  opaque  structure  type. 

Related  Commands 

XClipBox, XDestroyRegion, XEmptyRegion,  XEqualRegion,  Xlntersect- 
Region, XOf f setRegion, XPointlnRegion, XPolygonRegion,  XRectlnRegion, 
XSetRegion,  XShrinkRegion,  XSubtractRegion,  XUnionRectWithRegion, 
XUnionRegion,  XXorRegion. 
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Xlib  -  Window  Existence  — 


\ 


Name 

XCreateSimpleWindow  — create  an  unmapped  inputOutput  window. 

Synopsis 

Window  XCreateSimpleWindow (display,  parent,  x,  y,  width,  height, 
border_width,  border,  background) 

Display  * display ; 

Window  parent; 
int  x,  y; 

unsigned  int  width,  height,  border_width; 
unsigned  long  border; 
unsigned  long  background; 


Arguments 

di  spl  ay  Specifies  a  pointer  to  the  Di  spl  ay  structure;  returned  from  XOpenDi  spl  ay. 

parent  Specifies  the  parent  window  ID.  Must  be  an  InputOutput  window. 

x  Specify  the  x  and  y  coordinates  of  the  upper-left  pixel  of  the  new  window’s 

y  border  relative  to  the  origin  of  the  parent  (inside  the  parent  window’s  border). 


width  Specify  the  width  and  height,  in  pixels,  of  the  new  window.  These  are  the 

height  inside  dimensions,  not  including  the  new  window’s  borders,  which  are  entirely 

outside  of  the  window.  Must  be  nonzero.  Any  part  of  the  window  that  extends 
outside  its  parent  window  is  clipped. 


border_width 

Specifies  the  width,  in  pixels,  of  the  new  window’s  border. 
border  Specifies  the  pixel  value  for  the  border  of  the  window. 
background  Specifies  the  pixel  value  for  the  background  of  the  window. 


Description 

XCreateSimpleWindow  creates  an  unmapped  InputOutput  subwindow  of  the  specified 
parent  window.  Use  XCreateWindow  if  you  want  to  set  the  window  attributes  while  creating 
a  window.  (After  creation,  XChangeWindowAttributes  can  be  used.) 

XCreateSimpleWindow  returns  the  ID  of  the  created  window.  The  new  window  is  placed 
on  top  of  the  stacking  order  relative  to  its  siblings.  Note  that  the  window  is  unmapped  when  it 
is  created — use  Mapwindow  to  display  it.  This  function  generates  a  XCreateNotify  event. 

The  initial  conditions  of  the  window  are  as  follows: 

The  window  inherits  its  depth,  class,  and  visual  from  its  parent.  All  other  window  attributes 
have  their  default  values. 

All  properties  have  undefined  values. 

The  new  window  will  not  have  a  cursor  defined;  the  cursor  will  be  that  of  the  window’s  parent 
until  the  cursor  attribute  is  set  with  XDef  ineCursor  or  XChangeWindowAttributes. 
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(continued) 


XCreateSimpleWindow 


If  no  background  or  border  is  specified,  CopyFromParent  is  implied. 

For  more  information,  see  Volume  One,  Chapter  2,  X  Concepts ,  and  Volume  One,  Chapter  3, 
Basic  Window  Program. 

Errors 

BadAlloc 

BadMatch 

BadValue  width  or  height  is  zero. 

BadWindow  Specified  parent  is  an  Input  Only  window. 

Related  Commands 

XCreateWindow, XDestroySubwindows, XDestroyWindow. 
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XCreateWindow 


Xlib  -  Window  Existence  — 


\ 


Name 

XCreateWindow  —  create  a  window  and  set  attributes. 

Synopsis 

Window  XCreateWindow  ( display,  parent,  x,  y,  width,  height, 
border_width ,  depth,  class,  visual,  valuemask, 
attributes) 

Display  *  display ; 

Window  pa ren t ; 
int  x,  y; 

unsigned  int  width,  height ; 
unsigned  int  border_width ; 
int  depth; 
unsigned  int  class; 

Visual  * visual 
unsigned  long  valuemask ; 

XSetWindowAt tributes  *  attributes ; 


Arguments 

displ ay 
parent 


x 

y 

width 

height 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 

Specifies  the  parent  window.  Parent  must  be  Input  Output  if  class  of  win¬ 
dow  created  is  to  be  inputOutput. 

Specify  the  x  and  y  coordinates  of  the  upper-left  pixel  of  the  new  window’s 
border  relative  to  the  origin  of  the  parent  (upper  left  inside  the  parent’s  border). 

Specify  the  width  and  height,  in  pixels,  of  the  window.  These  are  the  new  win¬ 
dow’s  inside  dimensions.  These  dimensions  do  not  include  the  new  window’s 
borders,  which  are  entirely  outside  of  the  window.  Must  be  nonzero,  otherwise 
the  server  generates  a  BadValue  error. 


border_width 

Specifies  the  width,  in  pixels,  of  the  new  window’s  border.  Must  be  0  for 
InputOnly  windows,  otherwise  a  BadMatch  error  is  generated. 

depth  Specifies  the  depth  of  the  window,  which  is  less  than  or  equal  to  the  parent’s 

depth.  A  depth  of  CopyFromParent  means  the  depth  is  taken  from  the  par¬ 
ent.  Use  XListDepths  is  choosing  an  unusual  depth.  The  specified  depth 
paired  with  the  visual  argument  must  be  supported  on  the  screen. 

class  Specifies  the  new  window’s  class.  Pass  one  of  these  constants:  Input- 

Output,  InputOnly,  or  CopyFromParent. 

visual  Specifies  a  connection  to  an  visual  structure  describing  the  style  of  colormap  to 
be  used  with  this  window.  CopyFromParent  is  valid. 

valuemask  Specifies  which  window  attributes  are  defined  in  the  attributes  argument. 

If  valuemask  is  0,  attributes  is  not  referenced.  This  mask  is  the  bitwise 
OR  of  the  valid  attribute  mask  bits  listed  in  the  Structures  section  below. 
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(continued) 


XCreateWindow 


attributes  Attributes  of  the  window  to  be  set  at  creation  time  should  be  set  in  this  struc¬ 
ture.  The  valuemask  should  have  the  appropriate  bits  set  to  indicate  which 
attributes  have  been  set  in  the  structure. 

Description 

To  create  an  unmapped  subwindow  for  a  specified  parent  window  use  XCreateWindow  or 
XCreateSimpleWindow.  XCreateWindow  is  a  more  general  function  that  allows  you  to 
set  specific  window  attributes  when  you  create  the  window.  If  you  do  not  want  to  set  specific 
attributes  when  you  create  a  window,  use  XCreateSimpleWindow,  which  creates  a  window 
that  inherits  its  attributes  from  its  parent.  XCreateSimpleWindow  creates  only  Input- 
Output  windows  that  use  the  default  depth  and  visual. 

XCreateWindow  returns  the  ID  of  the  created  window.  XCreateWindow  causes  the  X 
server  to  generate  a  CreateNotify  event.  The  newly  created  window  is  placed  on  top  of  its 
siblings  in  the  stacking  order. 

Extension  packages  may  define  other  classes  of  windows. 

The  visual  should  be  Def  aultvisual  or  one  returned  by  XGetVisuallnf  o  or  XMatch- 
visuallnf o.  The  depth  should  be  Def aultDepth,  1,  or  a  depth  returned  by  XList- 
Depths.  In  current  implementations  of  Xlib,  if  you  specify  a  visual  other  than  the  one  used  by 
the  parent,  you  must  first  find  (using  XGetRGBColormaps)  or  create  a  colormap  matching 
this  visual  and  then  set  the  colormap  window  attribute  in  the  attributes  and  valuemask 
arguments.  Otherwise,  you  will  get  a  BadMatch  error. 

For  more  information,  see  Volume  One,  Chapter  4,  Window  Attributes. 


Structures 


/* 

*  Data  structure  for  setting  window  attributes. 


*/ 

typedef  struct  { 

Pixmap  background_pixmap;  /* 

unsigned  long  background_pixel;  /* 
Pixmap  border_pixmap;  /* 

unsigned  long  border_pixel;  /* 

int  bit_gravity;  /* 

int  win_gravity;  /* 

int  backing_store;  /* 

unsigned  long  backing_planes;  /* 

unsigned  long  backing_pixel;  /* 

Bool  save_under;  /* 

long  event_mask;  /* 

long  do_not_propagate_mask;  /* 

Bool  override_redirect ;  /* 

Colormap  colormap;  /* 

Cursor  cursor;  /* 

}  XSetWindowAtt ributes; 


background  or  None  or  ParentRelative  */ 

background  pixel  */ 

border  of  the  window  */ 

border  pixel  value  */ 

one  of  bit  gravity  values  */ 

one  of  the  window  gravity  values  */ 

NotUseful,  WhenMapped,  Always  */ 

planes  to  be  preseved  if  possible  */ 

value  to  use  in  restoring  planes  */ 

should  bits  under  be  saved  (popups)  */ 

set  of  events  that  should  be  saved  */ 

set  of  events  that  should  not  propagate  */ 

boolean  value  for  override-redirect  */ 

colormap  to  be  associated  with  window  */ 

cursor  to  be  displayed  (or  None)  */ 
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XCreateWindow 


(continued) 


Xlib  -  Window  Existence 


/*  Definitions  for  valuemask  argument  */ 


tdefine 

CWBackPixmap 

(1L«0) 

#define 

CWBackPixel 

(1L«1) 

#def ine 

CWBorderPixmap 

(1L«2) 

#define 

CWBorderPixel 

(1L«3) 

#define 

CWBitGravity 

(1L«4) 

#def ine 

CWWinGravity 

(1L«5) 

#def ine 

CWBackingStore 

(1L«6) 

tdefine 

CWBackingPlanes 

(1L«7) 

#define 

CWBackingPixel 

(1L«8) 

#def ine 

CWOver r ideRedi rect 

(1L«9) 

tdefine 

CWSaveUnder 

(1L«10) 

tdefine 

CWEventMask 

(1L«11) 

tdefine 

CWDontPropagate 

(1L«12) 

tdefine 

CWColormap 

(1L«13) 

tdefine 

CWCursor 

(1L«14) 

Errors 

BadAlloc 


BadColormap 

BadCursor 

BadMatch 

BadPixmap 

BadValue 

BadWindow 


Attribute  besides  win_gravity,  event_mask,  do_not_j?ropagate_ 
mask,  override_redirect  or  cursor  specified  for  InputOnly  win¬ 
dow. 

depth  nonzero  for  InputOnly. 

Parent  of  Input  Out  put  is  InputOnly. 
border_width  is  nonzero  for  InputOnly. 
depth  not  supported  on  screen  for  Input  Output. 
width  or  height  is  0. 
visual  not  supported  on  screen. 


Related  Commands 

XCreateSimpleWindow, XDestroySubwindows, XDestroyWindow,  XList- 
Depths. 
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—  Xlib  -  Cursors 


XDefineCursor 


/ 


Name 

XDefineCursor  —  assign  a  cursor  to  a  window. 

Synopsis 

XDefineCursor ( display,  w,  cursor) 

Display  *  display ; 

Window  w; 

Cursor  cursor; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

w  Specifies  the  ID  of  the  window  in  which  the  cursor  is  to  be  displayed. 

cursor  Specifies  the  cursor  to  be  displayed  when  the  pointer  is  in  the  specified  win¬ 

dow.  Pass  None  to  have  the  parent’s  cursor  displayed  in  the  window,  or  for 
the  root  window,  to  have  the  default  cursor  displayed. 

Description 

Sets  the  cursor  attribute  of  a  window,  so  that  the  specified  cursor  is  shown  whenever  this  win¬ 
dow  is  visible  and  the  pointer  is  inside.  If  XDefineCursor  is  not  called,  the  parent’s  cursor 
is  used  by  default. 

For  more  information  on  available  cursors,  see  Appendix  I,  The  Cursor  Font. 

Errors 

BadCursor 

BadWindow 

Related  Commands 

XCreateFontCursor, XCreateGlyphCursor,  XCreatePixmapCursor,  XFree- 
Cursor, XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndef ine- 
Cursor. 
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XDeleteAssoc 


Xlib  -  Association  Tables — 


\ 


Name 

XDeleteAssoc  —  delete  an  entry  from  an  association  table. 

Synopsis 

XDeleteAssoc ( display,  table ,  x_id) 

Display  *  display ; 

XAssocTable  *  table; 

XID  x_id; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
table  Specifies  one  of  the  association  tables  created  by  XCreateAssocTable. 

x_id  Specifies  the  X  resource  ID  of  the  association  to  be  deleted. 

Description 

This  function  is  provided  for  compatibility  with  X  Version  10.  To  use  it  you  must  include  the 
file  <X11/X10.h>  and  link  with  the  library  -loldX. 

XDeleteAssoc  deletes  an  association  in  an  XAssocTable  keyed  on  its  XID.  Redundant 
deletes  (and  deletes  of  nonexistent  xid’s)  are  meaningless  and  cause  no  problems.  Deleting 
associations  in  no  way  impairs  the  performance  of  an  XAssocTable. 

For  more  information  on  association  tables,  see  Volume  One,  Appendix  B,X10  Compatibility. 

Structures 

typedef  struct  { 

XAssoc  *buckets; 
int  size; 

}  XAssocTable; 

Related  Commands 

XCreateAssocTable,  XDestroyAssocTable, XLookUpAssoc, XMakeAssoc. 


/*  pointer  to  first  bucket  in  array  */ 
/*  table  size  (number  of  buckets)  */ 
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— Xlib  -  Context  Manager 


XDeleteContext 


/ 


Name 

XDeleteContext  —  delete  a  context  entry  for  a  given  window  and  type. 

Synopsis 

int  XDeleteContext ( display,  w,  context) 

Display  *  display ; 

Window  w; 

XContext  context ; 

Arguments 

display 

w 

context 

Description 

XDeleteContext  deletes  the  entry  for  the  given  window  and  type  from  the  context  data 
structure  defined  in  <X11/Xutil.h>.  This  function  returns  xcnoent  if  the  context  could  not  be 
found,  or  zero  if  it  succeeds.  XDeleteContext  does  not  free  the  memory  allocated  for  the 
data  whose  address  was  saved. 

See  Volume  One,  Chapter  13,  Other  Programming  Techniques ,  for  a  description  of  context 
management. 

Structures 

typedef  int  XContext; 

Related  Commands 

XFindContext, XSaveContext, XUniqueContext. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
Specifies  the  window  with  which  the  data  is  associated. 

Specifies  the  context  type  to  which  the  data  belongs. 
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Xlib  -  Resource  Manager  — 


XDeleteModifiermapEntry 


Name 

XDeleteModifiermapEntry  —  delete  an  entry  from  an  XModif  ierKeymap  structure. 

Synopsis 

XModif  ierKeymap  *XDeleteModif  iermapEntry  ( modmap , 
keysym_entry,  modifier) 

XModif ierKeymap  * modmap; 

Key Code  keysym_entry ; 
int  modifier ; 

Arguments 

modmap  Specifies  a  pointer  to  an  XModif  ierKeymap  structure. 

k eysym_ entry 

Specifies  the  keycode  of  the  key  to  be  deleted  from  modmap. 

modifier  Specifies  the  modifier  you  no  longer  want  mapped  to  the  keycode  specified  in 
keysym_entry.  This  should  be  one  of  the  constants:  ShiftMapIndex, 
LockMapIndex,  ControlMapIndex,  ModlMapIndex,  Mod2Map- 
Index,  Mod3MapIndex,  Mod4MapIndex,  or  Mod5MapIndex. 

Description 

XDeleteModifiermapEntry  returns  an  XModif  ierKeymap  structure  suitable  for  cal¬ 
ling  XSetModif  ierMapping,  in  which  the  specified  keycode  is  deleted  from  the  set  of  key- 
codes  that  is  mapped  to  the  specified  modifier  (like  Shift  or  Control).  XDelete¬ 
ModifiermapEntry  itself  does  not  change  the  mapping. 

This  function  is  normally  used  by  calling  XGetModif  ierMapping  to  get  a  pointer  to  the 
current  XModif  ierKeymap  structure  for  use  as  the  modmap  argument  to  XDelete¬ 
ModifiermapEntry. 

Note  that  the  structure  pointed  to  by  modmap  is  freed  by  XDeleteModifiermapEntry.  It 
should  not  be  freed  or  otherwise  used  by  applications  after  this  call. 

For  a  description  of  the  modifier  map,  see  XSetModif  ierMapping. 

Structures 

typedef  struct  { 

int  max_keypermod;  /*  server's  max  number  of  keys  per  modifier  */ 

KeyCode  *modif iermap;  /*  an  8  by  max_keypermod  array  of 

*  keycodes  to  be  used  as  modifiers  */ 

}  XModif ierKeymap; 


tdefine  ShiftMapIndex  0 
tdefine  LockMapIndex  1 
#define  ControlMapIndex  2 
#define  ModlMapIndex  3 
tdefine  Mod2MapIndex  4 
tdefine  Mod3MapIndex  5 
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Xlib  -  Resource  Manager 


(continued) 


XDeleteModifiermapEntry 


#define  Mod4MapIndex 
tdefine  Mod5MapIndex 


6 

7 


Related  Commands 

XFreeModif  iermap,  XGetKeyboardMapping,  XGetModif  ierMapping, 
XKeycodeToKeysym,  XKeysymToKeycode,  XKeysymToString,  XLookupKeysym, 
XLookupString,  XNewModif  iermap,  XQueryKeymap,  XRebindKeySym, 

XRef  reshKeyboardMapping,  XSetModif  ierMapping,  XStringToKeysym, 
InsertModifiermapEntry. 
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XDeleteProperty 


Xlib  -  Properties — 


\ 


Name 

XDeleteProperty  —  delete  a  window  property. 

Synopsis 

XDeleteProperty  ( display,  w,  property) 

Display  * display ; 

Window  w ; 

Atom  property ; 

Arguments 

displ ay 
w 

property 

Description 

XDeleteProperty  deletes  a  window  property,  so  that  it  no  longer  contains  any  data.  Its 
atom,  specified  by  property ,  still  exists  after  the  call  so  that  it  can  be  used  again  later  by  any 
application  to  set  the  property  once  again.  If  the  property  was  defined  on  the  specified  window, 
XDeleteProperty  generates  a  PropertyNotify  event. 

See  the  introduction  to  properties  in  Volume  One,  Chapter  2,  X  Concepts ,  or  more  detailed 
information  in  Volume  One,  Chapter  10,  Interclient  Communication. 

Errors 

BadAtom 

BadWindow 

Related  Commands 

XChangeProperty,  XGetAtomName,  XGetFontProperty,  XGetWindowProperty, 
XInternAtom,  XListProperties,  XRotateWindowProperties, XSetStandard- 
Properties. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
Specifies  the  ID  of  the  window  whose  property  you  want  to  delete. 
Specifies  the  atom  of  the  property  to  be  deleted. 
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—  Xlib  -  Association  Tables 


XDestroyAssocTable 


/ 


Name 

XDestroyAssocTable  —  free  the  memory  allocated  for  an  association  table. 

Synopsis 

XDestroyAssocTable (table) 

XAssocTable  *  table; 

Arguments 

table  Specifies  the  association  table  whose  memory  is  to  be  freed. 

Description 

This  function  is  provided  for  compatibility  with  X  Version  10.  To  use  it  you  must  include  the 
file  <X11/X10.h>  and  link  with  the  library  -loldX. 

Using  an  XAssocTable  after  it  has  been  destroyed  will  have  unpredictable  consequences. 

For  more  information  on  association  tables,  see  Volume  One,  Appendix  B,  XI 0  Compatibility . 

Structures 

typedef  struct  { 

XAssoc  *buckets;  /*  pointer  to  first  bucket  in  array  */ 

int  size;  /*  table  size  (number  of  buckets)  */ 

}  XAssocTable; 

Related  Commands 

XCreateAssocTable, XDeleteAssoc, XLookUpAssoc, XMakeAssoc. 
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XDestroylmage 


Xlib  -  Images — 


\ 


Name 

XDestroylmage  —  deallocate  memory  associated  with  an  image. 

Synopsis 

int  XDestroylmage  (ximage) 

Xlmage  *  ximage ; 


Arguments 

ximage  Specifies  a  pointer  to  the  image. 

Description 

XDestroylmage  deallocates  the  memory  associated  with  an  ximage  structure.  This  mem¬ 
ory  includes  both  the  memory  holding  the  Ximage  structure,  and  the  memory  holding  the 
actual  image  data.  (If  the  image  data  is  statically  allocated,  the  pointer  to  the  data  in  the 
ximage  structure  must  be  set  to  zero  before  calling  XDestroylmage.) 

For  more  information  on  images,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Related  Commands 

ImageByteOrder,  XAddPixel,  XCreatelmage,  XGetlmage,  XGetPixel,  XGet- 
Sublmage,  XPut Image, XPutPixel, XSub Image. 
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— Xlib  -  Regions 


XDestroyRegion 


/ 


Name 

XDestroyRegion  —  deallocate  storage  associated  with  a  region. 

Synopsis 

XDestroyRegion ( r) 

Region  r; 

Arguments 

r  Specifies  the  region  to  be  destroyed. 

Description 

XDestroyRegion  frees  the  memory  associated  with  a  region  and  invalidates  pointer  r. 
See  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text,  for  a  description  of  regions. 


Related  Commands 

XClipBox, XCreateRegion, XEmptyRegion, XEqualRegion,  Xlntersect- 
Region, XOf f setRegion, XPointlnRegion,  XPolygonRegion,  XRectlnRegion, 
XSetRegion, XShrinkRegion,  XSubtractRegion,  XUnionRectWithRegion, 
XUnionRegion,  XXorRegion. 
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XDestroySubwindows 


Xlib  -  Window  Existence  — 


\ 


Name 

XDestroySubwindows  —  destroy  all  subwindows  of  a  window. 

Synopsis 

XDestroySubwindows ( display,  w) 

Display  * display; 

Window  w; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

w  Specifies  the  ID  of  the  window  whose  subwindows  are  to  be  destroyed. 

Description 

This  function  destroys  all  descendants  of  the  specified  window  (recursively),  in  bottom  to  top 
stacking  order. 

XDestroySubwindows  generates  exposure  events  on  window  w,  if  any  mapped  subwindows 
were  actually  destroyed.  This  is  much  more  efficient  than  deleting  many  subwindows  one  at  a 
time,  since  much  of  the  work  need  only  be  performed  once  for  all  of  the  windows  rather  than 
for  each  window.  It  also  saves  multiple  exposure  events  on  the  windows  about  to  be  destroyed. 
The  subwindows  should  never  again  be  referenced. 

XCloseDi splay  automatically  destroys  all  windows  that  have  been  created  by  that  client  on 
the  specified  display  (unless  called  after  a  fork  system  call). 

Never  call  XDestroySubwindows  with  the  window  argument  set  to  the  root  window!  This 
will  destroy  all  the  applications  on  the  screen,  and  if  there  is  only  one  screen,  often  the  server 
as  well. 

Errors 

BadWindow 

Related  Commands 

XCreateSimpleWindow,  XCreateWindow,  XDestroyWindow. 
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—  Xlib  -  Window  Existence 


XDestroy  Window 


/ 


Name 

XDestroyWindow  —  unmap  and  destroy  a  window  and  all  subwindows. 

Synopsis 

XDestroyWindow ( display,  window) 

Display  * display ; 

Window  window ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

window  Specifies  the  ID  of  the  window  to  be  destroyed. 

Description 

If  window  is  mapped,  an  UnmapWindow  request  is  performed  automatically.  The  window 
and  all  inferiors  (recursively)  are  then  destroyed,  and  a  DestroyNotify  event  is  generated 
for  each  window.  The  ordering  of  the  DestroyNotify  events  is  such  that  for  any  given  win¬ 
dow,  DestroyNotify  is  generated  on  all  inferiors  of  the  window  before  being  generated  on 
the  window  itself.  The  ordering  among  siblings  and  across  subhierarchies  is  not  otherwise  con¬ 
strained. 

The  windows  should  never  again  be  referenced. 

Destroying  a  mapped  window  will  generate  exposure  events  on  other  windows  that  were 
obscured  by  the  windows  being  destroyed.  XDestroyWindow  may  also  generate  Enter- 
Notify  events  if  window  was  mapped  and  contained  the  pointer. 

No  windows  are  destroyed  if  you  try  to  destroy  the  root  window. 

Errors 

BadWindow 

Related  Commands 

XCreateSimpleWindow,  XCreateWindow,  XDestroySubwindows. 
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XDisableAccessControl 


Xlib  -  Host  Access— 


\ 


Name 

XDisableAccessControl  —  allow  access  from  any  host. 

Synopsis 

XDisableAccessControl  ( display ) 

Display  *  display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

Description 

XDisableAccessControl  instructs  the  server  to  allow  access  from  clients  on  any  host. 
This  disables  use  of  the  host  access  list. 

This  routine  can  only  be  called  from  a  client  running  on  the  same  host  as  the  server. 

For  more  information  on  access  control,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Errors 

BadAccess 

Related  Commands 

XAddHost, XAddHosts,  XEnableAccessControl, XListHosts,  XRemoveHost, 
XRemoveHosts, XSetAccessControl. 
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—  Xlib  -  Window  Manager  Hints 


XDisplayKeycodes 


/ 


Name 

XDisplayKeycodes  —  obtain  the  range  of  legal  keycodes  for  a  server. 

Synopsis 

XDisplayKeycodes  (display,  m±n_keycodes ,  max_keycod.es) 
Display  * display ; 

int  *min_keycode,  *max_keycode ;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

min_keycode  Returns  the  minimum  keycode. 

max_keycode  Returns  the  maximum  keycode. 

Description 

XDisplayKeycodes  returns  the  min_keycode  and  max_keycode  supported  by  the 
specified  server.  The  minimum  keycode  returned  is  never  less  than  8,  and  the  maximum  key- 
code  returned  is  never  greater  than  255.  Not  all  keycodes  in  this  range  are  required  to  have  cor¬ 
responding  keys. 

For  more  information,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Related  Commands 

XKeycodeToKeysym,  XKeysymToKeycode,  XLookupString. 
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XDisplayName 


Xlib  -  Error  Handling  — 


\ 


Name 

XDisplayName  —  report  the  display  name  (when  connection  to  a  display  fails). 

Synopsis 

char  ^XDisplayName  ( string) 
char  * string ; 

Arguments 

string  Specifies  the  character  string. 

Description 

XDisplayName  is  normally  used  to  report  the  name  of  the  display  the  program  attempted  to 
open  with  XOpenDisplay.  This  is  necessary  because  X  error  handling  begins  only  after  the 
connection  to  the  server  succeeds.  If  a  null  string  is  specified,  XDisplayName  looks  in  the 
DISPLAY  environment  variable  and  returns  the  display  name  that  the  user  was  requesting. 
Otherwise,  XDisplayName  returns  its  own  argument.  This  makes  it  easier  to  report  to  the 
user  precisely  which  server  the  program  attempted  to  connect  to. 

For  more  information,  see  Volume  One,  Chapter  3,  Basic  Window  Program. 

Related  Commands 

XGetErrorDatabaseText, XGetErrorText,  XSetAf terFunction,  XSetError- 
Handler, XSet IOErrorHandler,  XSynchronize. 
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—  Xlib  -  Drawing  Primitives 


XDraw 


/ 


Name 

XDraw  —  draw  a  polyline  or  curve  between  vertex  list  (from  XI 0 ) . 

Synopsis 

Status  XDraw (display,  drawable,  gc,  vlist,  vcount) 

Display  ^display ; 

Drawable  drawable; 

GC  gc; 

Vertex  *vlist; 
int  vcount ; 

Arguments 

display 

drawable 
gc 

vlist 
vcount 

Description 

This  function  is  provided  for  compatibility  with  X  Version  10.  To  use  it  you  must  include  the 
file  <X11/X10.h>  and  link  with  the  library  -loldX.  Its  performance  is  likely  to  be  low. 

XDraw  draws  an  arbitrary  polygon  or  curve.  The  figure  drawn  is  defined  by  the  specified  list  of 
vertices  (vlist).  The  points  are  connected  by  lines  as  specified  in  the  flags  each  the  Vertex 
structure. 

The  Vertex  structure  contains  an  x,y  coordinate  and  a  bitmask  called  flags  that  specifies 
the  drawing  parameters. 

The  x  and  y  elements  of  Vertex  are  the  coordinates  of  the  vertex  that  are  relative  to  either  the 
previous  vertex  (if  VertexRelative  is  1)  or  the  upper-left  inside  comer  of  the  drawable  (if 
VertexRelative  is  0).  If  VertexRelative  is  0  the  coordinates  are  said  to  be  absolute. 
The  first  vertex  must  be  an  absolute  vertex. 

If  the  VertexDontDraw  bit  is  1,  no  line  or  curve  is  drawn  from  the  previous  vertex  to  this 
one.  This  is  analogous  to  picking  up  the  pen  and  moving  to  another  place  before  drawing 
another  line. 

If  the  VertexCurved  bit  is  1,  a  spline  algorithm  is  used  to  draw  a  smooth  curve  from  the  pre¬ 
vious  vertex,  through  this  one,  to  the  next  vertex.  Otherwise,  a  straight  line  is  drawn  from  the 
previous  vertex  to  this  one.  It  makes  sense  to  set  VertexCurved  to  1  only  if  a  previous  and 
next  vertex  are  both  defined  (either  explicitly  in  the  array,  or  through  the  definition  of  a  closed 
curve — see  below.) 

It  is  permissible  for  VertexDontDraw  bits  and  VertexCurved  bits  to  both  be  1.  This  is 
useful  if  you  want  to  define  the  previous  point  for  the  smooth  curve,  but  you  do  not  want  an 
actual  curve  drawing  to  start  until  this  point. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  the  list  of  vertices  that  indicates  what  to  draw. 
Specifies  how  many  vertices  are  in  vlist. 
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XDraw 


(continued) 


Xlib  -  Drawing  Primitives 


If  VertexStartClosed  bit  is  1,  then  this  point  marks  the  beginning  of  a  closed  curve.  This 
vertex  must  be  followed  later  in  the  array  by  another  vertex  whose  absolute  coordinates  are 
identical  and  which  has  VertexEndClosed  bit  of  1.  The  points  in  between  form  a  cycle  for 
the  purpose  of  determining  predecessor  and  successor  vertices  for  the  spline  algorithm. 

XDraw  achieves  the  effects  of  the  X10  XDraw,  XDrawDashed,  and  XDrawPatterned 
functions. 

XDraw  uses  the  following  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  join_style,  fill_style,  subwindow_ 
mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  This  function  also  uses 
these  graphics  context  mode-dependent  components:  foreground,  background,  tile, 
stipple,  ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

A  Status  of  zero  is  returned  on  failure,  and  nonzero  on  success. 

For  more  information,  see  Volume  One,  Appendix  B,  XI 0  Compatibility. 

Structures 

typedef  struct  _Vertex  { 
short  x,y; 

unsigned  short  flags; 

}  Vertex; 


/*  defined  constants  for  use 
tdefine  VertexRelative 

as  flags 
0x0001 

*/ 

/* 

else 

absolute 

*/ 

#def ine 

VertexDontDraw 

0x0002 

/* 

else 

draw  */ 

#def ine 

VertexCurved 

0x0004 

/* 

else 

straight 

*/ 

tdefine 

VertexStartClosed 

0x0008 

/* 

else 

not  */ 

#def ine 

VertexEndClosed 

0x0010 

/* 

else 

not  */ 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDrawArc,  XDrawArcs, 
XDrawFilled,  XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs,  XFill- 
Polygon,  XFillRectangle, XFillRectangles. 
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XDrawArc 


/ 


Name 

XDrawArc  —  draw  an  arc  fitting  inside  a  rectangle. 

Synopsis 

XDrawArc  ( display,  drawable ,  gc ,  x,  y,  width ,  height, 
anglel ,  angle2) 

Display  * display ; 

Drawable  drawable; 

GC  gc; 
int  x,  y; 

unsigned  int  width,  height; 
int  anglel,  angle2 ; 

Arguments 

display 

drawable 
gc 
x 

y 

width 
height 

anglel 

angle 2 

Description 

XDrawArc  draws  a  circular  or  elliptical  arc.  An  arc  is  specified  by  a  rectangle  and  two  angles. 
The  x  and  y  coordinates  are  relative  to  the  origin  of  the  drawable,  and  define  the  upper-left  cor¬ 
ner  of  the  rectangle.  The  center  of  the  circle  or  ellipse  is  the  center  of  the  rectangle,  and  the 
major  and  minor  axes  are  specified  by  the  width  and  height,  respectively.  The  angles  are 
signed  integers  in  64ths  of  a  degree,  with  positive  values  indicating  counterclockwise  motion 
and  negative  values  indicating  clockwise  motion,  truncated  to  a  maximum  of  360  degrees.  The 
start  of  the  arc  is  specified  by  anglel  relative  to  the  three-o’clock  position  from  the  center, 
and  the  path  and  extent  of  the  arc  is  specified  by  angle2  relative  to  the  start  of  the  arc. 

By  specifying  one  axis  to  be  zero,  a  horizontal  or  vertical  line  is  drawn  (inefficiently). 

Angles  are  computed  based  solely  on  the  coordinate  system  and  ignore  the  aspect  ratio.  In 
other  words,  if  the  bounding  rectangle  of  the  arc  is  not  square  and  anglel  is  zero  and 
angle2  is  (45x64),  a  point  drawn  from  the  center  of  the  bounding  box  through  the  endpoint 
of  the  arc  will  not  pass  through  the  comer  of  the  rectangle. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle  that 
contains  the  arc,  relative  to  the  origin  of  the  specified  drawable. 

Specify  the  width  and  height  in  pixels  of  the  major  and  minor  axes  of  the  arc. 

Specifies  the  start  of  the  arc  relative  to  the  three-o’clock  position  from  the 
center.  Angles  are  specified  in  64ths  of  a  degree  (360  *  64  is  a  complete 
circle). 

Specifies  the  end  of  the  arc  relative  to  the  start  of  the  arc.  Angles  are  speci¬ 
fied  in  64ths  of  a  degree  (360  *  64  is  a  complete  circle). 
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XDrawArc 


(continued) 


Xlib  -  Drawing  Primitives 


For  any  given  arc,  no  pixel  is  drawn  more  than  once,  even  if  angle2  is  greater  than  anglel 
by  more  than  360  degrees. 

XDrawArc  uses  these  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  join_style,  fill_style,  subwindow_ 
mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  This  function  also  uses 
these  graphics  context  mode-dependent  components:  foreground,  background,  tile, 
stipple,  ts_x_origin,  ts_y__origin,  dash_of  f  set,  and  dash_list. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 


Angle  =  270x64=17280 
Angle  =  -( 90x64 ) =5760 


Example  1 : 

Arc  from  A1  to  A2,  Counterclockwise 
A1  =  90  X  64 
A2  =  45  X  64 


Example  2: 

Arc  from  B1  to  B2,  Clockwise 
B1  =  270  X  64 
B2  =  -(45X64) 


Errors 

BadDrawable 

BadGC 

BadMatch 
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(continued) 


XDrawArc 


Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArcs, 
XDrawFilled,  XDrawLine,  XDrawLines,  XDrawPoint,  XDrawPoints,  XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle,  XFillRectangles. 
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XDrawArcs 


Xlib  -  Drawing  Primitives— 


\ 


Name 

XDrawArcs  —  draw  multiple  arcs. 

Synopsis 

XDrawArcs ( display,  drawable ,  gc ,  arcs,  narcs) 
Display  *display ; 

Drawable  drawable ; 

GC  gc; 

XArc  *arcs; 
int  narcs; 


Arguments 

display 

drawable 

gc 

arcs 

narcs 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  arcs. 

Specifies  the  number  of  arcs  in  the  array. 


Example  1 : 

Arc  from  A1  to  A2,  Counterclockwise 
A1  =  90  X  64 
A2  =  45  X  64 


Example  2: 

Arc  from  B1  to  B2,  Clockwise 
B1  =  270  X  64 
B2  =  -(45X64) 
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(continued) 


XDrawArcs 


Description 

This  is  the  plural  version  of  XDrawArc.  See  XDrawArc  for  details  of  drawing  a  single  arc. 

There  is  a  limit  to  the  number  of  arcs  that  can  be  drawn  in  a  single  call.  It  varies  according  to 
the  server.  To  determine  how  many  arcs  you  can  draw  in  a  single  call,  find  out  your  server’s 
maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  divide  by  three:  this  is  the 
maximum  number  of  arcs  you  can  draw  in  a  single  XDrawArcs  call. 

The  arcs  are  drawn  in  the  order  listed  in  the  arcs  array. 

By  specifying  one  axis  to  be  zero,  a  horizontal  or  vertical  line  can  be  drawn.  Angles  are  com¬ 
puted  based  solely  on  the  coordinate  system,  ignoring  the  aspect  ratio. 

For  any  given  arc,  no  pixel  is  drawn  more  than  once.  If  the  last  point  in  one  arc  coincides  with 
the  first  point  in  the  following  arc,  the  two  arcs  will  join  correctly.  If  the  first  point  in  the  first 
arc  coincides  with  the  last  point  in  the  last  arc,  the  two  arcs  will  join  correctly.  If  two  arcs  join 
correctly  and  if  line_width  is  greater  than  0  and  the  arcs  intersect,  no  pixel  is  drawn  more 
than  once.  Otherwise,  the  intersecting  pixels  of  intersecting  arcs  are  drawn  multiple  times. 
Specifying  an  arc  with  one  endpoint  and  a  clockwise  extent  draws  the  same  pixels  as  specifying 
the  other  endpoint  and  an  equivalent  counterclockwise  extent,  except  as  it  affects  joins. 

XDrawArcs  uses  these  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  join_style,  fill_style,  subwindow_ 
mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  This  function  also  uses 
these  graphics  context  mode-dependent  components:  foreground,  background,  tile, 
stipple,  ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

The  following  is  a  technical  explanation  of  the  points  drawn  by  XDrawArcs.  For  an  arc  speci¬ 
fied  as  [x,  y,  width,  height,  angle  1,  angle2] ,  the  origin  of  the  major  and  minor  axes  is 
at  [x+  (width/2 ) ,  y+  (height /2 )  ] ,  and  the  infinitely  thin  path  describing  the  entire  circle 
or  ellipse  intersects  the  horizontal  axis  at  [x,  y+ (height/2) ]  and  [x+width, 
y+ (height/2) ]  and  intersects  the  vertical  axis  at  [x+ (width/2)  ,y]  and 
[x+ (width/2) ,  y+height].  These  coordinates  can  be  fractional.  That  is,  they  are  not 
truncated  to  discrete  coordinates.  The  path  should  be  defined  by  the  ideal  mathematical  path. 
For  a  wide  line  with  line  width  line_width,  the  bounding  outlines  for  filling  are  given  by 
the  infinitely  thin  paths  describing  the  arcs: 

[x+dx/2,  y+dy/2,  width-dx,  height-dy,  anglel,  angle2] 

and 

[x-line_width/2,  y-line_width/2,  width+line_width,  height+line_width, 
anglel,  angle2] 

where 

dx=min (line_width, width) 
dy=min (line_width, height) 
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(continued) 
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If  (height  !=  width)  the  angles  must  be  specified  in  the  effectively  skewed  coordinate 
system  of  the  ellipse  (for  a  circle,  the  angles  and  coordinate  systems  are  identical).  The  rela¬ 
tionship  between  these  angles  and  angles  expressed  in  the  normal  coordinate  system  of  the 
screen  (as  measured  with  a  protractor)  is  as  follows: 

skewed-angle  =  atan (tan (normal-angle)  *  width/height)  +  adjust 

The  skewed-angle  and  normal-angle  are  expressed  in  radians  (rather  than  in  64ths  of  a  degree) 
in  the  range  [0,2*PI],  and  where  atan  returns  a  value  in  the  range  [ -PI/2,  PI/2] ,  and 
where  adjust  is: 

0  for  normal-angle  in  the  range  [0,PI/2] 

PI  for  normal-angle  in  the  range  [PI/2,  (3*PI) /2] 

2*PI  for  normal-angle  in  the  range  [  (3*PI) /2, 2*PI] 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

typedef  struct  { 
short  x,  y; 

unsigned  short  width,  height; 
short  anglel,  angle2; 

}  XArc ; 

Errors 

BadDrawable 
BadGC 
BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawFilled,  XDrawLine,  XDrawLines,  XDrawPoint,  XDrawPoints,  XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs,  XFill- 
Polygon,  XFillRectangle, XFillRectangles. 


/*  Start  and  end  of  arc,  in  */ 
/*  64ths  of  degrees  */ 
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XDrawFilled 


/ 


Name 

XDrawFilled  —  draw  a  filled  polygon  or  curve  from  vertex  list  (from  X10 ) . 

Synopsis 

Status  XDrawFilled ( display,  drawable,  gc,  vlist,  vcount) 

Display  ^display ; 

Drawable  drawable ; 

GC  gc; 

Vertex  * vlist; 
int  vcount ; 

Arguments 

displ ay 
drawable 
gc 

vlist 
vcount 

Description 

This  function  is  provided  for  compatibility  with  X  Version  10.  To  use  it  you  must  include  the 
file  <X11/X10.h>  and  link  with  the  library  -loldX.  XDrawFilled  achieves  the  effects  of  the 
X  Version  10  XDrawTiled  and  XDrawFilled  functions. 

XDrawFilled  draws  arbitrary  polygons  or  curves,  according  to  the  same  rules  as  XDraw,  and 
then  fills  them. 

XDrawFilled  uses  the  following  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  join_style,  fill_style, 
subwindow_mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  This  function 
also  uses  these  graphics  context  mode-dependent  components:  foreground,  background, 
tile,  stipple,  ts_x_origin,  ts_y_origin,  dash_offset,  dash_list, 
f  ill_style  and  f  ill_rule. 

XDrawFilled  returns  a  Status  of  zero  on  failure,  and  nonzero  on  success. 

For  more  information,  see  Volume  One,  Appendix  B,  XI 0  Compatibility . 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc, XFillArcs,  XFill- 
Polygon, XFillRectangle,  XFillRectangles. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  the  list  of  vertices. 

Specifies  how  many  vertices  are  in  vlist. 
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XDrawImageString 


Xlib  -  Text — 


\ 


Name 

XDrawImageString  —  draw  8-bit  image  text  characters. 

Synopsis 

XDrawImageString  ( display,  drawable ,  gc ,  x,  y,  string,  length) 
Display  *  display ; 

Drawable  drawable ; 

GC  gc; 
int  x ,  y; 
char  *  string ; 
int  length; 

Arguments 

displ ay 
drawable 
gc 
x 

y 

string 
length 

Description 

XDrawImageString  draws  a  string,  but  unlike  XDrawString  it  draws  both  the  foreground 
and  the  background  of  the  characters.  It  draws  the  characters  in  the  foreground  and  fills  the 
bounding  box  with  the  background. 

XDrawImageString  uses  these  graphics  context  components:  plane_mask,  fore¬ 
ground,  background,  font,  subwindow_mode,  clip_x_origin,  clip_y_ 
origin,  and  clip_mask.  The  function  and  fill_style  defined  in  gc  are  ignored; 
the  effective  function  is  GXcopy  and  the  effective  f  ill_style  is  FillSolid. 

XDrawImageString  first  fills  a  destination  rectangle  with  the  background  pixel  defined 
in  gc,  and  then  paints  the  text  with  the  foreground  pixel.  The  upper-left  comer  of  the  filled 
rectangle  is  at  [x,  y  -  font_ascent],  the  width  is  overall->width  and  the  height  is 
ascent  +  descent,  where  overall->width,  ascent,  and  descent  are  as  would  be 
returned  by  XQueryTextExtents  using  gc  and  string. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Errors 

BadDrawable 

BadGC 

BadMatch 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  image 
text  character,  relative  to  the  origin  of  the  specified  drawable. 

Specifies  the  character  string. 

Specifies  the  number  of  characters  in  the  string  argument. 
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(continued) 


XDrawImageString 


Related  Commands 

XDrawImageStringl6,  XDrawString,  XDrawStringl6,  XDrawText,  XDraw- 
Textl6,  XQueryTextExtents, XQueryTextExtentsl6, XTextExtents, XText- 
Extentsl6,  XTextWidth,  XTextWidthl6. 
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XDrawImageStringl  6 


Xlib-Text — 


\ 


Name 

XDrawImageStringl6  —  draw  16-bit  image  text  characters. 

Synopsis 

XDrawImageStringl 6 ( display,  drawable ,  gc ,  x,  y,  string ,  length) 
Display  ^display ; 

Drawable  drawable; 

GC  gc; 
int  x ,  y; 

XChar2b  * string ; 
int  length; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
drawable  Specifies  the  drawable. 


gc 

x 

y 


Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  image 
text  character,  relative  to  the  origin  of  the  specified  drawable. 


string  Specifies  the  character  string. 

length  Specifies  the  number  of  characters  in  the  string  argument. 

Description 

XDrawImageStringl  6  draws  a  string,  but  unlike  XDrawStringl6  it  draws  both  the  fore¬ 
ground  and  the  background  of  the  characters.  It  draws  the  characters  in  the  foreground  and  fills 
the  bounding  box  with  the  background. 


XDrawImageStringl 6  uses  these  graphics  context  components:  plane_mask,  fore¬ 
ground,  background,  font,  subwindow__mode,  clip_x_origin,  clip_y_ 
origin,  and  clip_mask.  The  function  and  fill_style  defined  in  gc  are  ignored; 
the  effective  function  is  GXcopy  and  the  effective  f  ill_style  is  FillSolid. 

XDrawImageStringl 6  first  fills  a  destination  rectangle  with  the  background  pixel 
defined  in  gc,  and  then  paints  the  text  with  the  foreground  pixel.  The  upper-left  comer  of 
the  filled  rectangle  is  at  [x,  y  -  font_ascent],  the  width  is  overall->width  and  the 
height  is  ascent  +  descent,  where  overall->width,  ascent,  and  descent  are  as 
would  be  returned  by  XQueryTextExtentsl6  using  gc  and  string. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 


Structures 

typedef  struct  { 

unsigned  char  bytel; 
unsigned  char  byte2; 
}  XChar2b; 
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(continued) 


XDrawlmageString16 


Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XDrawImageString, XD rawString, XDrawStringl6, XDrawText, XDrawTextl6, 
XQueryTextExtents, XQueryTextExtentsl6, XTextExtents,  XText- 
Extentsl6,  XTextWidth,  XTextWidthl6. 
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XDrawLine 


Xlib  -  Drawing  Primitives— 


\ 


Name 

XDrawLine  —  draw  a  line  between  two  points. 

Synopsis 

XDrawLine (  display,  drawable ,  gc ,  xl ,  yl ,  x2 ,  y2) 

Display  * display ; 

Drawable  drawable; 

GC  gc; 

int  xl ,  yl ,  x2 ,  y2 ; 

Arguments 

di  spl  ay 
drawable 
gc 
xl 

yi 

x2 
y2 

Description 

XDrawLine  uses  the  components  of  the  specified  graphics  context  to  draw  a  line  between  two 
points  in  the  specified  drawable.  No  pixel  is  drawn  more  than  once. 

XDrawLine  uses  these  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  fill_style,  subwindow_mode,  clip_ 
x_origin,  clip_y_origin,  and  clip_mask.  XDrawLine  also  uses  these  graphics  con¬ 
text  mode-dependent  components:  foreground,  background,  tile,  stipple, 
ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Errors 

BadDrawable  Specified  drawable  is  invalid. 

BadGC  Specified  GC  is  invalid,  or  does  not  match  the  depth  of  drawable. 

BadMatch  Specified  drawable  is  an  InputOnly  window. 

Related  Commands 

XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled,  XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs,  XFill- 
Polygon,  XFillRectangle,  XFillRectangles. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  coordinates  of  the  endpoints  of  the  line  relative  to  the  drawable 
origin.  XLine  connects  point  (xl ,  yl)  to  point  {x2,  y2). 
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XDrawLines 


/ 


Name 

XDrawLines  —  draw  multiple  connected  lines. 

Synopsis 

XDrawLines ( display,  drawable,  gc ,  points,  npoints,  mode) 

Display  ^display ; 

Drawable  drawable ; 

GC  gc; 

XPoint  *points; 
int  npoints ; 
int  mode ; 

Arguments 

di  spl  ay 

drawable 
gc 

points 
npoints 
mode 

Description 

XDrawLines  draws  a  series  of  lines  joined  end-to-end. 

It  draws  lines  connecting  each  point  in  the  list  {points  array)  to  the  next  point  in  the  list.  The 
lines  are  drawn  in  the  order  listed  in  the  points  array.  For  any  given  line,  no  pixel  is  drawn 
more  than  once.  If  thin  (zero  line  width)  lines  intersect,  pixels  will  be  drawn  multiple  times.  If 
the  first  and  last  points  coincide,  the  first  and  last  lines  will  join  correctly.  If  wide  lines  inter¬ 
sect,  the  intersecting  pixels  are  drawn  only  once,  as  though  the  entire  multiline  request  were  a 
single  filled  shape. 

There  is  a  limit  to  the  number  of  lines  that  can  be  drawn  in  a  single  call,  that  varies  according  to 
the  server.  To  determine  how  many  lines  you  can  draw  in  a  single  call,  you  find  out  your 
server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  divide  by  two,  and 
this  is  the  maximum  number  of  lines  you  can  draw  in  a  single  XDrawLines  call. 

The  mode  argument  may  have  two  values: 

•  CoordModeOrigin  indicates  that  all  points  are  relative  to  the  drawable’s  origin. 

•  CoordModePrevious  indicates  that  all  points  after  the  first  are  relative  to  the  previ¬ 
ous  point.  (The  first  point  is  always  relative  to  the  drawable’s  origin.) 

XDrawLines  uses  the  following  components  of  the  specified  graphics  context  to  draw  multi¬ 
ple  connected  lines  in  the  specified  drawable:  function,  plane_rnask,  line_width, 
line_style,  cap_style,  join_style,  fill_style,  subwindow_mode, 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  points. 

Specifies  the  number  of  points  in  the  array. 

Specifies  the  coordinate  mode.  Pass  either  CoordModeOrigin  or  Coord¬ 
ModePrevious. 
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XDrawLines 


(continued) 


Xlib  -  Drawing  Primitives 


clip_x_origin,  clip_y_  origin,  and  clip_mask.  This  function  also  uses  these 
graphics  context  mode-dependent  components:  foreground,  background,  tile, 
stipple,  ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
short  x,  y; 

}  XPoint; 

Errors 

BadDrawable  Specified  drawable  is  invalid. 

BadGC  Specified  GC  is  invalid,  or  does  not  match  the  depth  of  drawable. 

BadMatch  Specified  drawable  is  an  InputOnly  window. 

BadValue  Invalid  coordinate_mode. 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawPoint,  XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc, XFillArcs,  XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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XDrawPoint 


/ 


Name 

XDrawPoint  —  draw  a  point. 

Synopsis 

XDrawPoint  ( display,  drawable,  gc ,  x,  y) 

Display  ^display ; 

Drawable  drawable ; 

GC  gc; 
int  x ,  y; 

Arguments 

di  spl  ay 
drawable 
gc 
x 

y 

Description 

XDrawPoint  draws  a  single  point  into  the  specified  drawable.  XDrawPoint  uses  these 
graphics  context  components:  function,  plane_mask,  foreground,  subwin- 
dow_mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  Use  XDrawPoints 
to  draw  multiple  points. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs,  XDrawFilled,  XDrawLine,  XDrawLines, XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle,  XFillRectangles. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  point,  relative  to  the  origin  of  the  draw- 
able. 
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Xlib  -  Drawing  Primitives— 


\ 


Name 

XDrawPoints  —  draw  multiple  points. 

Synopsis 

XDrawPoints  ( display,  drawable ,  gc ,  points ,  npoints,  mode) 
Display  *  display ; 

Drawable  drawable; 

GC  gc ; 

XPoint  *points ; 
int  npoints; 
int  mode ; 

Arguments 

di  spl  ay 

drawable 
gc 

points 

npoints 
mode 


Description 

XDrawPoints  draws  one  or  more  points  into  the  specified  drawable. 

There  is  a  limit  to  the  number  of  points  that  can  be  drawn  in  a  single  call,  that  varies  according 
to  the  server.  To  determine  how  many  points  you  can  draw  in  a  single  call,  you  find  out  your 
server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  this  is  the  maxi¬ 
mum  number  of  points  you  can  draw  in  a  single  XDrawPoints  call. 

XDrawPoints  uses  these  graphics  context  components:  function,  plane_mask,  fore¬ 
ground,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and  clip_mask. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
short  x,  y; 

}  XPoint; 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  XPoint  structures  containing  the  positions 
of  the  points. 

Specifies  the  number  of  points  to  be  drawn. 

Specifies  the  coordinate  mode.  CoordModeOrigin  treats  all  coordinates  as 
relative  to  the  origin,  while  CoordModePrevious  treats  all  coordinates 
after  the  first  as  relative  to  the  previous  point,  while  the  first  is  still  relative  to 
the  origin. 
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(continued) 


XDrawPoints 


Errors 

BadDrawable 

BadGC 

BadMatch 

BadValue 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled,  XDrawLine, XDrawLines, XDrawPoints, XDraw- 
Rectangle,  XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs, XFill- 
Polygon,  XFillRectangle,  XFillRectangles. 
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Xlib  -  Drawing  Primitives— 


\ 


Name 

XDrawRectangle  —  draw  an  outline  of  a  rectangle. 

Synopsis 

XDrawRectangle ( displ ay,  drawable,  gc ,  x,  y,  width ,  height) 
Display  ^display ; 

Drawable  drawable ; 

GC  gc; 
int  x ,  y; 

unsigned  int  width,  height; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
dr  a  wabl  e  Specifies  the  drawable. 

gc  Specifies  the  graphics  context. 


x  Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle,  rela- 

y  tive  to  the  drawable* s  origin. 


width  Specify  the  width  and  height  in  pixels.  These  dimensions  define  the  outline 

height  of  the  rectangle. 


20  pixels 


20  pixels 


C -  > 

T 

1 2  pixels 

XDrawRectangle  (display,  drawable,  gc,  0,  0,  19,  11);  XFil lRectangle  (display,  drawable,  gc,  0,  0,  19,  11); 


Description 

XDrawRectangle  draws  the  outline  of  the  rectangle  by  using  the  x  and  y  coordinates, 
width  and  height ,  and  graphics  context  you  specify.  Specifically,  XDrawRectangle  uses 
these  graphics  context  components:  function,  plane_mask,  line_width, 
line_style,  cap_style,  join_style,  fill_style,  subwindow_mode,  clip_ 
x_origin,  clip_y_origin,  and  clip_mask.  This  function  also  uses  these  graphics  con¬ 
text  mode-dependent  components:  foreground,  background,  tile,  stipple, 
ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

For  the  specified  rectangle,  no  pixel  is  drawn  more  than  once. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 
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(continued) 


XDrawRectangle 


Structure 

typedef  struct  { 
short  x,  y; 

unsigned  short  width,  height; 

}  XRectangle; 

Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines,  XDrawPoint,  XDrawPoints, 
XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle, XFillRectangles. 
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Xlib  -  Drawing  Primitives — 


\ 


Name 

XDrawRectangles  —  draw  the  outlines  of  multiple  rectangles. 

Synopsis 

XDrawRectangles ( display,  drawable,  gc ,  rectangles,  nrectangles) 
Display  ^display ; 

Drawable  drawable ; 

GC  gc; 

XRectangle  rectangles [] ; 
int  nrectangles ; 


Arguments 

displ ay 

drawable 

gc 

rectangles 

nrectangles 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  rectangles  containing  position  and  size 
information. 

Specifies  the  number  of  rectangles  in  the  array. 


XSrawRectangle  (display,  drawable,  gc,  0,  0,  19,  11);  XFi HRectangle  (display,  drawable,  gc,  0,  0,  19,  11); 

Description 

XDrawRectangles  draws  the  outlines  of  the  specified  rectangles  by  using  the  position  and 
size  values  in  the  array  of  rectangles.  The  x  and  y  coordinates  of  each  rectangle  are  relative  to 
the  drawable’s  origin,  and  define  the  upper-left  comer  of  the  rectangle. 

The  rectangles  are  drawn  in  the  order  listed.  For  any  given  rectangle,  no  pixel  is  drawn  more 
than  once.  If  rectangles  intersect,  pixels  are  drawn  multiple  times. 

There  is  a  limit  to  the  number  of  rectangles  that  can  be  drawn  in  a  single  call.  It  varies  accord¬ 
ing  to  the  server.  To  determine  how  many  rectangles  you  can  draw  in  a  single  call,  find  out 
your  server’s  maximum  request  size  using  XMaxRe quest  Size.  Subtract  3  and  divide  by 
two.  This  is  the  maximum  number  of  rectangles  you  can  draw  in  a  single  XDraw¬ 
Rectangles  call. 

This  function  uses  these  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  join_style,  fill_style,  subwin- 
dow_mode,  clip_x_origin,  clip_y_origin,  and  clip_mask.  XDrawRectangles 
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(continued) 


XDrawRectangles 


also  uses  these  graphics  context  mode-dependent  components:  foreground,  background, 
tile,  stipple,  ts_x_origin,  ts_y_origin,  dash_of  f  set,  and  dash_list. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
short  x,  y; 

unsigned  short  width,  height; 

}  XRectangle; 

Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled,  XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle,  XDrawSegments, XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle,  XFillRectangles. 
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Xlib  -  Drawing  Primitives — 


\ 


Name 

XDrawSegments  —  draw  multiple  disjoint  lines. 

Synopsis 

XDrawSegments ( display,  drawable,  gc,  segments ,  nsegments) 

Display  ^display ; 

Drawable  drawable ; 

GC  gc; 

XSegment  *  segments ; 
int  nsegments ; 

Arguments 

di  spl  ay 

drawable 
gc 

segments 
nsegments 

Description 

XDrawSegments  draws  multiple  line  segments  into  the  specified  drawable.  Each  line  is 
specified  by  a  pair  of  points,  so  the  line  may  be  connected  or  disjoint. 

For  each  segment,  XDrawSegments  draws  a  line  between  (xl,  yl)  and  (x2,  y2 ).  The 
lines  are  drawn  in  the  order  listed  in  segments.  For  any  given  line,  no  pixel  is  drawn  more 
than  once.  If  lines  intersect,  pixels  will  be  drawn  multiple  times.  The  lines  will  be  drawn  sepa¬ 
rately,  without  regard  to  the  join_style. 

There  is  a  limit  to  the  number  of  segments  that  can  be  drawn  in  a  single  call.  It  varies  accord¬ 
ing  to  the  server.  To  determine  how  many  segments  you  can  draw  in  a  single  call,  find  out  your 
server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  divide  by  two. 
This  is  the  maximum  number  of  segments  you  can  draw  in  a  single  XDrawSegments  call. 

XDrawSegments  uses  these  graphics  context  components:  function,  plane_mask, 
line_width,  line_style,  cap_style,  fill_style,  subwindow__mode,  clip_ 
x_origin,  clip_y_origin,  and  clip_mask.  XDrawSegments  also  uses  these  graph¬ 
ics  context  mode-dependent  components:  foreground,  background,  tile,  stipple, 
ts_x_origin,  ts  y  origin,  dash_of  f  set,  and  dash_list. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 

short  xl,  yl,  x2,  y2; 

}  XSegment; 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  line  segments. 

Specifies  the  number  of  segments  in  the  array. 
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(continued) 


XDrawSegments 


Errors 

BadDrawable  Specified  drawable  is  invalid. 

BadGC  Specified  GC  is  invalid,  or  does  not  match  the  depth  of  drawable. 

BadMatch  Specified  drawable  is  an  inputOnly  window. 

Related  Commands 

XClearArea,  XClearWindow, XCopyArea, XCopyPlane, XDraw,  XDrawArc, 
XDrawArcs,  XDrawFilled,  XDrawLine,  XDrawLines,  XDrawPoint,  XDrawPoints, 
XDrawRectangle, XDrawRectangles, XFillArc,  XFillArcs,  XFillPolygon, 
XFillRectangle,  XFillRectangles. 
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Name 

XDrawString  —  draw  an  8-bit  text  string,  foreground  only. 

Synopsis 

XDrawString ( display,  drawable ,  gc ,  x,  y,  string,  length) 

Display  *  display ; 

Drawable  drawable; 

GC  gc ; 
int  x,  y; 
char  * string ; 
int  length ; 

Arguments 

displ  ay 

drawable 
gc 
x 

y 

string 
length 

Description 

XDrawString  draws  the  given  string  into  a  drawable  using  the  foreground  only  to  draw 
set  bits  in  the  font.  It  does  not  affect  any  other  pixels  in  the  bounding  box  for  each  character. 

The  y  coordinate  defines  the  baseline  row  of  pixels  while  the  x  coordinate  is  the  point  from 
which  lbearing,  rbearing,  and  width  are  measured. 

XDrawString  uses  these  graphics  context  components:  function,  plane_mask, 
fill_style,  font,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  tile,  stipple,  ts_x_origin,  and  ts_y_origin.  Each  character 
image,  as  defined  by  the  font  in  gc,  is  treated  as  an  additional  mask  for  a  fill  operation  on  the 
drawable. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Errors 

BadDrawable 

BadFont 

BadGC 

BadMatch 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  char¬ 
acter,  relative  to  the  origin  of  the  specified  drawable. 

Specifies  the  character  string. 

Specifies  the  number  of  characters  in  string. 
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(continued) 


XDrawString 


Related  Commands 

XD rawImageString, XDrawImageStringl6, XDrawStringl6,  XDrawText, 
XDrawTextl6, XQueryTextExtents, XQueryTextExtentsl6, XTextExtents, 
XTextExtents  1 6,  XTextWidth,  XTextWidthl  6. 
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Xlib  -  Text — 


\ 


Name 

XDrawStringl6  —  draw  two-byte  text  strings. 

Synopsis 

XDrawStringl 6 ( display,  drawable,  gc ,  x,  y,  string,  length) 
Display  * display ; 

Drawable  drawable ; 

GC  gc; 
int  x,  y; 

XChar2b  * string ; 
int  length ; 

Arguments 

di  spl  ay 

drawable 
gc 
x 

y 

string 
length 

Description 

XDrawStringl 6  draws  a  string  in  the  foreground  pixel  value  without  drawing  the  surround¬ 
ing  pixels. 

The  y  coordinate  defines  the  baseline  row  of  pixels  while  the  x  coordinate  is  the  point  from 
which  lbearing,  rbearing,  and  width  are  measured.  For  more  information  on  text 
placement,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

XDrawStringl 6  uses  these  graphics  context  components:  function,  plane_mask, 
fill_style,  font,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  tile,  stipple,  ts_x_origin,  and  ts_y_origin.  Each  character 
image,  as  defined  by  the  font  in  gc,  is  treated  as  an  additional  mask  for  a  fill  operation  on  the 
drawable. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 

unsigned  char  bytel; 
unsigned  char  byte2; 

}  XChar2b; 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  char¬ 
acter,  relative  to  the  origin  of  the  specified  drawable. 

Specifies  the  character  string.  Characters  are  two  bytes  wide. 

Specifies  the  number  of  characters  in  string. 
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(continued) 


XDrawString16 


Errors 

BadDrawable 

BadFont 

BadGC 

BadMatch 

Related  Commands 

XDrawImageSt ring,  XDrawImageStringl6,  XDrawString,  XDrawText,  XDraw- 
Textl6,  XQueryText Extents, XQueryTextExtentsl6, XTextExtents, XText- 
Extentsl6,  XTextWidth,  XTextWidthl6. 
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Name 

XDrawText  —  draw  8-bit  polytext  strings. 

Synopsis 

XDrawText ( display,  drawable,  gc ,  x,  y,  items,  nitems) 

Display  ^display ; 

Drawable  drawable; 

GC  gc; 
int  x,  y; 

XTextltem  * items; 
int  nitems; 

Arguments 

display 
drawable 
gc 
x 

y 

items 
nitems 

Description 

XDrawText  is  capable  of  drawing  multiple  strings  on  the  same  horizontal  line  and  changing 
fonts  between  strings.  Each  XTextltem  structure  contains  a  string,  the  number  of  characters 
in  the  string,  the  delta  offset  from  the  starting  position  for  the  string,  and  the  font.  Each  text 
item  is  processed  in  turn.  The  font  in  each  XTextltem  is  stored  in  the  specified  GC  and  used 
for  subsequent  text.  If  the  XTextltem .  font  is  None,  the  font  in  the  GC  is  used  for  drawing 
and  is  not  changed.  Switching  between  fonts  with  different  drawing  directions  is  permitted. 

The  delta  in  each  XTextltem  specifies  the  change  in  horizontal  position  before  the  string  is 
drawn.  The  delta  is  always  added  to  the  character  origin  and  is  not  dependent  on  the  draw 
direction  of  the  font.  For  example,  if  x  =  40,  y  =  2  0,  and  items  [0]  .delta  =  8,  the 
string  specified  by  items  [0]  .chars  would  be  drawn  starting  at  x  =  48,  y  =  20.  The 
delta  for  the  second  string  begins  at  the  rbearing  of  the  last  character  in  the  first  string.  A 
negative  delta  would  tend  to  overlay  subsequent  strings  on  the  end  of  the  previous  string. 

Only  the  pixels  selected  in  the  font  are  drawn  (the  background  member  of  the  GC  is  not  used 
to  fill  the  bounding  box). 

There  is  a  limit  to  the  number  and  size  of  strings  that  can  be  drawn  in  a  single  call,  that  varies 
according  to  the  server.  To  determine  how  much  text  you  can  draw  in  a  single  call,  you  find  out 
your  server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  four,  and  then  sub¬ 
tract  (  (strlen  (string)  +2)  /  4)  for  each  string.  This  is  the  maximum  amount  of 

text  you  can  draw  in  a  single  XDrawText  call. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  initial 
string,  relative  to  the  origin  of  the  specified  drawable. 

Specifies  a  pointer  to  an  array  of  text  items. 

Specifies  the  number  of  text  items  in  the  items  array. 
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(continued) 


XDrawText 


XDrawText  uses  the  following  elements  in  the  specified  GC:  function,  plane_mask, 
fill_style,  font,  subwindow_mode,  clip_x_origin,  clip__y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  tile,  stipple,  ts_x_origin,  and  ts_y_origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
char  *chars; 
int  nchars; 
int  delta; 

Font  font; 

}  XTextltem; 

Errors 

BadDrawable 
BadFont 
BadGC 
BadMatch 

Related  Commands 

XDrawImageString, XDrawImageStringl6, XDrawString,  XDrawStringl6, 
XDrawTextl6, XQueryTextExtents, XQueryTextExtentsl6, XTextExtents, 
XTextExtentsl6,  XTextWidth,  XTextWidthl6. 


/*  pointer  to  string  */ 

/*  number  of  characters  */ 

/*  delta  between  strings  */ 

/*  font  to  print  it  in.  None  don't  change  */ 
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Name 

XDrawTextl6  —  draw  16-bit  polytext  strings. 

Synopsis 

XDrawTextl 6  (display,  drawable,  gc ,  x,  y,  items,  nitems) 

Display  ^display ; 

Drawable  drawable ; 

GC  gc ; 
int  x,  y; 

XTextIteml6  *  items; 
int  nitems; 

Arguments 

displ  ay 

drawable 
gc 
x 

y 

items 
nitems 

Description 

XDrawTextl 6  is  capable  of  drawing  multiple  strings  on  the  same  horizontal  line  and  chang¬ 
ing  fonts  between  strings.  Each  XTextltem  structure  contains  a  string,  the  number  of  charac¬ 
ters  in  the  string,  the  delta  offset  from  the  starting  position  for  the  string,  and  the  font.  Each 
text  item  is  processed  in  turn.  The  font  in  each  XTextltem  is  stored  in  the  specified  GC  and 
used  for  subsequent  text.  If  the  XTextiteml6  .  font  is  None,  the  font  in  the  GC  is  used  for 
drawing  and  is  not  changed.  Switching  between  fonts  with  different  drawing  directions  is  per¬ 
mitted. 

The  delta  in  each  XTextltem  specifies  the  change  in  horizontal  position  before  the  string  is 
drawn.  The  delta  is  always  added  to  the  character  origin  and  is  not  dependent  on  the  drawing 
direction  of  the  font.  For  example,  if  x  =  40,  y  =  20,  and  items  [0]  .delta  =  8,  the 
string  specified  by  items  [0]  . chars  would  be  drawn  starting  at  x  =  48,  y  =  20.  The 
delta  for  the  second  string  begins  at  the  rbearing  of  the  last  character  in  the  first  string.  A 
negative  delta  would  tend  to  overlay  subsequent  strings  on  the  end  of  the  previous  string. 

Only  the  pixels  selected  in  the  font  are  drawn  (the  background  member  of  the  GC  is  not  used 
to  fill  the  bounding  box). 

There  is  a  limit  to  the  number  and  size  of  strings  that  can  be  drawn  in  a  single  call,  that  varies 
according  to  the  server.  To  determine  how  much  text  you  can  draw  in  a  single  call,  you  find  out 
your  server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  four,  and  then  sub¬ 
tract  (  (strlen  (string)  +  2)  /  4)  for  each  string.  This  is  the  maximum  amount  of 
text  you  can  draw  in  a  single  XDrawTextl 6  call. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  baseline  starting  position  for  the  initial 
string,  relative  to  the  origin  of  the  specified  drawable. 

Specifies  a  pointer  to  an  array  of  text  items  using  two-byte  characters. 
Specifies  the  number  of  text  items  in  the  array. 
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(continued) 


XDrawTextl  6 


XDrawTextl6  uses  the  following  elements  in  the  specified  GC:  function,  plane_mask, 
fill_style,  font,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  tile,  stipple,  ts_x_origin,  and  ts_y_origin. 

Note  that  the  chars  member  of  the  XTextIteml6  structure  is  of  type  XChar2b,  rather  than 
of  type  char  as  it  is  in  the  XTextltem  structure.  For  fonts  defined  with  linear  indexing 
rather  than  two-byte  matrix  indexing,  the  X  server  will  interpret  each  member  of  the  XChar2b 
structure  as  a  16-bit  number  that  has  been  transmitted  most  significant  byte  first.  In  other 
words,  the  bytel  member  of  the  XChar2b  structure  is  taken  as  the  most  significant  byte. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 

XChar2b  *chars; 
int  nchars; 
int  delta; 

Font  font; 

}  XTextIteml6; 

typedef  struct  { 

unsigned  char  bytel; 
unsigned  char  byte2; 

}  XChar2b; 

Errors 

BadDrawable 
BadFont 
BadGC 
BadMatch 

Related  Commands 

XDrawImageString,  XDrawImageStringl6,  XDrawString,  XDrawStringl 6, 
XDrawText, XQueryTextExtents, XQueryTextExtentsl6, XTextExtents, 
XTextExtentsl6,  XTextWidth,  XTextWidthl6. 


/*  2  byte  characters  */ 

/*  number  of  characters  */ 

/*  delta  between  strings  */ 

/*  font  to  print  it  in.  None  don't  change  */ 

/*  normal  16  bit  characters  are  two  bytes  */ 
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XEmptyRegion 


Xlib  -  Regions— 


\ 


Name 

XEmptyRegion  —  determine  if  a  region  is  empty. 

Synopsis 

Bool  XEmptyRegion ( r) 

Region  r; 

Arguments 

r  Specifies  the  region  to  be  checked. 

Description 

XEmptyRegion  will  return  True  if  the  specified  region  is  empty,  or  False  otherwise. 

Structures 

Region  is  a  pointer  to  an  opaque  structure  type. 

Related  Commands 

XClipBox,  XCreateRegion,  XDestroyRegion, XEqualRegion, Xlntersect- 
Region,  XOf f setRegion, XPointlnRegion, XPolygonRegion, XRectlnRegion, 
XSetRegion,  XShrinkRegion,  XSubtractRegion,  XUnionRectWithRegion, 
XUnionRegion,  XXorRegion. 
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XEnableAccessControl 


/ 


Name 

XEnableAccessControl  —  use  access  control  list  to  allow  or  deny  connection  requests. 

Synopsis 

XEnableAccessControl ( display ) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Description 

XEnableAccessControl  instructs  the  server  to  use  the  host  access  list  to  determine 
whether  access  should  be  granted  to  clients  seeking  a  connection  with  the  server. 

By  default,  the  host  access  list  is  used.  If  access  has  not  been  disabled  with  XDisable- 
AccessControl  or  XSetAccessControl,  this  routine  does  nothing. 

This  routine  can  only  be  called  by  clients  running  on  the  same  host  as  the  server. 

For  more  information,  see  Volume  One,  Chapter  13,  Other  Programming  Techniques. 

Errors 

BadAccess 

Related  Commands 

XAddHost,  XAddHosts,  XDisableAccessControl, XListHosts, XRemoveHost, 
XRemoveHosts,  XSetAccessControl. 
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XEqualRegion 


Xlib  -  Regions — 


\ 


Name 

XEqualRegion  —  determine  if  two  regions  have  the  same  size,  offset,  and  shape. 

Synopsis 

Bool  XEqualRegion  (  rl ,  r2) 

Region  rl ,  r2 ; 

Arguments 

rl  Specify  the  two  regions  you  want  to  compare. 

r2 

Description 

XEqualRegion  returns  True  if  the  two  regions  are  identical;  i.e.,  they  have  the  same  offset, 
size  and  shape,  or  False  otherwise. 

Regions  are  located  using  an  offset  from  a  point  (the  region  origin )  which  is  common  to  all 
regions.  It  is  up  to  the  application  to  interpret  the  location  of  the  region  relative  to  a  drawable. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

Region  is  a  pointer  to  an  opaque  structure  type. 

Related  Commands 

XClipBox,  XCreateRegion,  XDestroyRegion, XEmptyRegion, Xlntersect- 
Region,  XOf f setRegion, XPoint InRegion,  XPolygonRegion,  XRectlnRegion, 
XSetRegion,  XShrinkRegion,  XSubtractRegion,  XUnionRectWithRegion, 
XUnionRegion,  XXorRegion. 
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XEventsQueued 


/ 


Name 

XEventsQueued  —  check  the  number  of  events  in  the  event  queue. 

Synopsis 

int  XEventsQueued (  display,  mode) 

Display  ^display ; 
int  mode; 

Arguments 

display  Specifies  a  connection  to  a  Display  structure,  returned  from  XOpen- 
Display. 

mode  Specifies  whether  the  request  buffer  is  flushed  if  there  are  no  events  in  Xlib’s 

queue.  You  can  specify  one  of  these  constants:  QueuedAl ready, 
QueuedAf terFlush, QueuedAfterReading. 

Description 

XEventsQueued  checks  whether  events  are  queued.  If  there  are  events  in  Xlib’s  queue,  the 
routine  returns  immediately  to  the  calling  routine.  Its  return  value  is  the  number  of  events 
regardless  of  mode. 

mode  specifies  what  happens  if  no  events  are  found  on  Xlib’s  queue. 

•  If  mode  is  QueuedAl  ready,  and  there  are  no  events  in  the  queue,  XEvents¬ 
Queued  returns  zero  (it  does  not  flush  the  request  buffer  or  attempt  to  read  more 
events  from  the  connection). 

•  If  mode  is  QueuedAf  terFlush,  and  there  are  no  events  in  the  queue,  XEvents¬ 
Queued  flushes  the  request  buffer,  attempts  to  read  more  events  out  of  the  applica¬ 
tion’s  connection,  and  returns  the  number  read. 

•  If  mode  is  QueuedAfterReading,  and  there  are  no  events  in  the  queue, 
XEventsQueued  attempts  to  read  more  events  out  of  the  application’s  connection 
without  flushing  the  request  buffer  and  returns  the  number  read. 

Note  that  XEventsQueued  always  returns  immediately  without  I/O  if  there  are  events 
already  in  the  queue. 

XEventsQueued  with  mode  QueuedAf  terFlush  is  identical  in  behavior  to  XPending. 
XEventsQueued  with  mode  QueuedAl  ready  is  identical  to  the  QLength  macro  (see 
Appendix  C,  Macros). 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 

Related  Commands 

QLength, XAllowEvents, XChecklf Event,  XCheckMaskEvent,  XCheckTyped- 
Event,  XCheckTypedWindowEvent,  XCheckWindowEvent,  XGet InputFocus, 
XGetMotionEvents,  Xlf  Event,  XMaskEvent,  XNextEvent,  XPeekEvent,  XPeek- 
IfEvent, XPending, XPutBackEvent,  XSelectlnput,  XSendEvent,  XSetlnput- 
Focus, XSynchronize, XWindowEvent. 
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XFetch  Buffer 


Xlib- Cut  Buffers— 


\ 


Name 

XFetchBuffer  —  return  data  from  a  cut  buffer. 

Synopsis 

char  *XFetchBuf fer ( display,  nbytes ,  buffer) 

Display  * display ; 

int  *  nbytes;  /*  RETURN  */ 

int  buffer ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

nbytes  Returns  the  number  of  bytes  in  buffer  returned  by  XFetchBuffer.  If 

there  is  no  data  in  the  buffer,  *  nbytes  is  set  to  0. 

buffer  Specifies  which  buffer  you  want  data  from.  Specify  an  integer  from  0  to  7 

inclusive. 

Description 

XFetchBuffer  returns  data  from  one  of  the  8  buffers  provided  for  interclient  communica¬ 
tion.  If  the  buffer  contains  data,  XFetchBuffer  returns  the  number  of  bytes  in  nbytes , 
otherwise  it  returns  null  and  sets  *  nbytes  to  0.  The  appropriate  amount  of  storage  is  allo¬ 
cated  and  the  pointer  returned;  the  client  must  free  this  storage  when  finished  with  it  by  calling 
XFree.  Note  that  the  cut  buffer  does  not  necessarily  contain  text,  so  it  may  contain  embedded 
null  bytes  and  may  not  terminate  with  a  null  byte. 

Selections  are  preferred  over  cut  buffers  as  a  communication  scheme. 

For  more  information  on  cut  buffers,  see  Volume  One,  Chapter  13,  Other  Programming  Tech¬ 
niques. 

Errors 

BadValue  buffer  not  an  integer  between  0  and  7  inclusive. 

Related  Commands 

XFetchBytes, XRotateBuf fers, XStoreBuf fer,  XStoreBytes. 
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XFetch  Bytes 


/ 


Name 

XFetchBytes  —  return  data  from  cut  buffer  0. 

Synopsis 

char  *XFetchBytes ( display,  nbytes) 

Display  * display ; 

int  *  nbytes;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

nbytes  Returns  the  number  of  bytes  in  the  string  returned  by  XFetchBytes.  If 

there  is  no  data  in  the  buffer,  *  nbytes  is  set  to  0. 

Description 

XFetchBytes  returns  data  from  cut  buffer  0  of  the  8  buffers  provided  for  interclient  commu¬ 
nication.  If  the  buffer  contains  data,  XFetchBytes  returns  the  number  of  bytes  in  nbytes, 
otherwise  it  returns  NULL  and  sets  *  nbytes  to  0.  The  appropriate  amount  of  storage  is  allo¬ 
cated  and  the  pointer  returned;  the  client  must  free  this  storage  when  finished  with  it  by  calling 
XFree.  Note  that  the  cut  buffer  does  not  necessarily  contain  text,  so  it  may  contain  embedded 
null  bytes  and  may  not  terminate  with  a  null  byte. 

Use  XFetchBuf  fer  to  fetch  data  from  any  specified  cut  buffer. 

Selections  are  preferred  over  cut  buffers  as  a  communication  method. 

For  more  information  on  cut  buffers,  see  Volume  One,  Chapter  13,  Other  Programming  Tech¬ 
niques. 

Related  Commands 

XFetchBuf  fer,  XRotateBuf  f  ers,  XStoreBuf  fer,  XStoreBytes. 
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XFetchName 


Xlib  -  Window  Manager  Hints— 


Name 

XFetchName  —  get  a  window’s  name  (xa  wm  name  property). 

Synopsis 

Status  XFetchName  ( display,  w,  window_name) 

Display  *  display ; 

Window  w ; 

char  **window_name ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  ID  of  the  window  whose  name  you  want  a  pointer  set  to. 

window_name  Returns  a  pointer  to  the  window  name,  which  will  be  a  null-terminated  string. 

If  the  xa_wm_name  property  has  not  been  set  for  this  window,  XFetchName 
sets  windowname  to  NULL.  When  finished  with  it,  a  client  can  free  the  name 
string  using  XFree. 

Description 

XFetchName  is  superseded  by  XGetWMName  in  Release  4.  XFetchName  returns  the  current 
value  of  the  xa  wm  name  property  for  the  specified  window.  XFetchName  returns  nonzero  if 
it  succeeds,  and  zero  if  the  property  has  not  been  set  for  the  argument  window. 

For  more  information,  see  Volume  One,  Chapter  10,  Interclient  Communication ,  and  Chapter 
14,  Window  Management. 

Errors 

BadWindow 

Related  Commands 

XGetClassHint, XGet IconName, XGet IconSizes,  XGetNormalHints,  XGet- 
SizeHints,  XGetTransientForHint, XGetWMHints, XGetZoomHints, XSet- 
ClassHint,  XSetCommand,  XSetlconName,  XSetlconSizes, XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints,  XSetZoomHints, 
XStoreName. 
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XFillArc 


/ 


Name 

XFillArc  —  fill  an  arc. 

Synopsis 

XFillArc  ( display,  drawable,  gc ,  x,  y,  width,  height, 
anglel ,  angle2) 

Display  * display ; 

Drawable  drawable ; 

GC  gc; 
int  x,  y; 

unsigned  int  width,  height; 
int  anglel,  angle2 ; 

Arguments 

di  spl  ay 

drawable 
gc 
x 

y 

width 
height 

anglel 
angle2 

Description 

XFillArc  draws  a  filled  arc.  The  x,  y,  width ,  and  height  arguments  specify  the  bounding 
box  for  the  arc.  See  XDrawArc  for  the  description  of  how  this  bounding  box  is  used  to  com¬ 
pute  the  arc.  Some,  but  not  all,  of  the  pixels  drawn  with  XDrawArc  will  be  drawn  by  XFill¬ 
Arc  with  the  same  arguments.  See  XFillRectangle  for  an  example  of  the  differences  in 
pixels  drawn  by  the  draw  and  fill  routines. 

The  arc  forms  one  boundary  of  the  area  to  be  filled.  The  other  boundary  is  determined  by  the 
arc_mode  in  the  GC.  If  the  arc_mode  in  the  GC  is  ArcChord,  the  single  line  segment 
joining  the  endpoints  of  the  arc  is  used.  If  ArcPieSlice,  the  two  line  segments  joining  the 
endpoints  of  the  arc  with  the  center  point  are  used. 

XFillArc  uses  these  graphics  context  components:  function,  plane_mask, 
fill_style,  arc_mode,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  background,  tile,  stipple,  ts_x_origin,  and  ts_y_  origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text,  and  Chapter  5, 
The  Graphics  Context. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  bounding  box 
containing  the  arc,  relative  to  the  origin  of  the  drawable. 

Specify  the  width  and  height  in  pixels.  These  are  the  major  and  minor  axes  of 
the  arc. 

Specifies  the  start  of  the  arc  relative  to  the  three-o’clock  position  from  the 
center.  Angles  are  specified  in  64ths  of  degrees. 

Specifies  the  path  and  extent  of  the  arc  relative  to  the  start  of  the  arc.  Angles 
are  specified  in  64ths  of  degrees. 
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XFIllArc 


(continued) 


Xlib  -  Drawing  Primitives 


Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines,  XDrawPoint,  XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArcs, XFill- 
Polygon, XFillRectangle,  XFillRectangles. 
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XFillArcs 


/ 


Name 

XFillArcs  —  fill  multiple  arcs. 


Synopsis 

XFillArcs ( display,  drawable,  gc ,  arcs,  narcs) 
Display  ^display ; 

Drawable  drawable; 

GC  gc; 

XArc  *arcs; 
int  narcs; 


Arguments 


displ  ay 

Specifies 

drawable 

Specifies 

gc 

Specifies 

arcs 

Specifies 

narcs 

Specifies 

a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

the  drawable. 

the  graphics  context. 

a  pointer  to  an  array  of  arc  definitions. 

the  number  of  arcs  in  the  array. 


Description 

For  each  arc,  XFillArcs  fills  the  region  closed  by  the  specified  arc  and  one  or  two  line  seg¬ 
ments,  depending  on  the  arc_mode  specified  in  the  GC.  It  does  not  draw  the  complete  out¬ 
lines  of  the  arcs,  but  some  pixels  may  overlap. 


The  arc  forms  one  boundary  of  the  area  to  be  filled.  The  other  boundary  is  determined  by  the 
arc_mode  in  the  GC.  If  the  arc_mode  in  the  GC  is  ArcChord,  the  single  line  segment 
joining  the  endpoints  of  the  arc  is  used.  If  ArcPieSlice,  the  two  line  segments  joining  the 
endpoints  of  the  arc  with  the  center  point  are  used.  The  arcs  are  filled  in  the  order  listed  in  the 
array.  For  any  given  arc,  no  pixel  is  drawn  more  than  once.  If  filled  arcs  intersect,  pixels  will 
be  drawn  multiple  times. 


There  is  a  limit  to  the  number  of  arcs  that  can  be  filled  in  a  single  call,  that  varies  according  to 
the  server.  To  determine  how  many  arcs  you  can  fill  in  a  single  call,  you  find  out  your  server’s 
maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  divide  by  three,  and  this  is 
the  maximum  number  of  arcs  you  can  fill  in  a  single  XFillArcs  call. 


XFillArcs  use  these  graphics  context  components:  function,  plane_mask, 
f  ill_style,  arc_mode,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and 
clip_mask.  This  function  also  uses  these  graphics  context  mode-dependent  components: 
foreground,  background,  tile,  stipple,  ts_x_origin,  and  ts_y_  origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text,  and  Chapter  5, 
The  Graphics  Context. 


Structures 

typedef  struct  { 
short  x,  y; 

unsigned  short  width,  height; 


Xlib  Reference  Manual 


183 


XFill  Arcs 


(continued) 


Xlib  -  Drawing  Primitives 


short  anglel,  angle2;  /*  64ths  of  Degrees  */ 

}  XArc; 

Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs,  XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle,  XDrawRectangles, XDrawSegments,  XFillArc,  XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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XFillPolygon 


/ 


Name 

XFillPolygon  —  fill  a  polygon. 

Synopsis 

XFillPolygon ( display,  drawable ,  gc ,  points,  npoints,  shape,  mode) 
Display  ^display ; 

Drawable  drawable; 

GC  gc; 

XPoint  * points ; 
int  npoints; 
int  shape; 
int  mode ; 

Arguments 


di  spl  ay 

Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

drawable 

Specifies  the  drawable. 

gc 

Specifies  the  graphics  context. 

points 

Specifies  a  pointer  to  an  array  of  points. 

npoints 

Specifies  the  number  of  points  in  the  array. 

shape 

Specifies  an  argument  that  helps  the  server  to  improve  performance.  Pass  the 
last  constant  in  this  list  that  is  valid  for  the  polygon  to  be  filled:  Complex, 
Nonconvex,  or  Convex. 

mode 

Specifies  the  coordinate  mode.  Pass  either  CoordModeOrigin  or  Coord¬ 
ModePrevious. 

Description 

XFillPolygon  fills  the  region  closed  by  the  specified  path.  Some  but  not  all  of  the  path 
itself  will  be  drawn.  The  path  is  closed  automatically  if  the  last  point  in  the  list  does  not  coin¬ 
cide  with  the  first  point.  No  pixel  of  the  region  is  drawn  more  than  once. 

The  mode  argument  affects  the  interpretation  of  the  points  that  define  the  polygon: 

•  CoordModeOrigin  indicates  that  all  points  are  relative  to  the  drawable’s  origin. 

•  CoordModePrevious  indicates  that  all  points  after  the  first  are  relative  to  the  previ¬ 
ous  point.  (The  first  point  is  always  relative  to  the  drawable’s  origin.) 

The  shape  argument  allows  the  fill  routine  to  optimize  its  performance  given  tips  on  the  confi¬ 
guration  the  area. 

•  Complex  indicates  the  path  may  self-intersect.  The  f  ill_rule  of  the  GC  must  be 
consulted  to  determine  which  areas  are  filled.  See  Volume  One,  Chapter  5,  The  Graphics 
Context ,  for  a  discussion  of  the  fill  rules  EvenOddRule  and  windingRule. 
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(continued) 


Xlib  -  Drawing  Primitives 


•  Nonconvex  indicates  the  path  does  not  self-intersect,  but  the  shape  is  not  wholly  con¬ 
vex.  If  known  by  the  client,  specifying  Nonconvex  instead  of  Complex  may  improve 
performance.  If  you  specify  Nonconvex  for  a  self-intersecting  path,  the  graphics 
results  are  undefined. 

•  Convex  means  that  for  every  pair  of  points  inside  the  polygon,  the  line  segment  con¬ 
necting  them  does  not  intersect  the  path.  This  can  improve  performance  even  more,  but 
if  the  path  is  not  convex,  the  graphics  results  are  undefined. 

Contiguous  coincident  points  in  the  path  are  not  treated  as  self-intersection. 

XFillPolygon  uses  these  graphics  context  components  when  filling  the  polygon  area: 
function,  plane_mask,  fill_style,  fill_rule,  subwindow_mode,  clip_ 
x_origin,  clip_y_origin,  and  clip_mask.  This  function  also  uses  these  mode-depen¬ 
dent  components  of  the  GC:  foreground,  background,  tile,  stipple, 
ts_x_origin,  and  ts_y_origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
short  x,  y; 

}  XPoint ; 

Errors 

BadDrawable 

BadGC 

BadMatch 

BadValue 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs, 
XFillRectangle, XFillRectangles. 
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XFillRectangle 


/ 


Name 

XFillRectangle  —  fill  a  rectangular  area. 

Synopsis 

XFillRectangle  ( display,  drawable,  gc ,  x,  y,  width,  height) 
Display  ^display ; 

Drawable  drawable ; 

GC  gc; 
int  x,  y; 

unsigned  int  width,  height; 


Arguments 

display 

drawable 

gc 

x 

y 

width 

height 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle,  rela¬ 
tive  to  the  origin  of  the  drawable. 

Specify  the  dimensions  in  pixels  of  the  rectangle  to  be  filled. 


XDrawRectangle  (display,  drawable,  gc,  0,  0,  19,  11);  XFillRectangle  (display,  drawable,  cz,  C,  0,  19,  11); 

Description 

XFillRectangle  fills  the  rectangular  area  in  the  specified  drawable  using  the  x  and  y  coor¬ 
dinates,  width  and  height  dimensions,  and  graphics  context  you  specify.  XFill¬ 
Rectangle  draws  some  but  not  all  of  the  path  drawn  by  XDrawRectangle  with  the  same 
arguments. 

XFillRectangle  uses  these  graphics  context  components:  function,  plane_mask, 
fill_style,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and  clip_ 
mask.  This  function  also  uses  these  graphics  context  components  depending  on  the 
fill_style:  foreground,  background  tile,  stipple,  ts_x_origin,  and 
ts_y_origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 
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(continued) 
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Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs,  XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs, 
XFillPolygon,  XFillRectangles. 


188 


Xlib  Reference  Manual 
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XFillRectangles 


/ 


Name 

XFillRectangles  —  fill  multiple  rectangular  areas. 

Synopsis 

XFillRectangles ( display,  drawable,  gc,  rectangles ,  nrectangles) 
Display  ^display ; 

Drawable  drawable ; 

GC  gc; 

XRectangle  *  rectangles ; 
int  nrectangles ; 


Arguments 

displ ay 

drawable 

gc 

rectangles 

nrectangles 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable. 

Specifies  the  graphics  context. 

Specifies  a  pointer  to  an  array  of  rectangles. 

Specifies  the  number  of  rectangles  in  the  array. 


Description 

XFillRectangles  fills  multiple  rectangular  areas  in  the  specified  drawable  using  the  graph¬ 
ics  context. 

The  x  and  y  coordinates  of  each  rectangle  are  relative  to  the  drawable’s  origin,  and  define  the 
upper  left  comer  of  the  rectangle.  The  rectangles  are  drawn  in  the  order  listed.  For  any  given 
rectangle,  no  pixel  is  drawn  more  than  once.  If  rectangles  intersect,  the  intersecting  pixels  will 
be  drawn  multiple  times. 

There  is  a  limit  to  the  number  of  rectangles  that  can  be  filled  in  a  single  call,  that  varies  accord¬ 
ing  to  the  server.  To  determine  how  many  rectangles  you  can  fill  in  a  single  call,  you  find  out 
your  server’s  maximum  request  size  using  XMaxRequestSize.  Subtract  3  and  divide  by 
two,  and  this  is  the  maximum  number  of  rectangles  you  can  fill  in  a  single  XDraw- 
Rectangles  call. 

XFillRectangles  uses  these  graphics  context  components:  function,  plane_mask, 
fill_style,  subwindow_mode,  clip_x_origin,  clip_y_origin,  and  clip_ 
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XFillRectangles 


(continued) 
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mask.  This  function  also  uses  these  graphics  context  components  depending  on  the  fill_ 
style:  foreground,  background,  tile,  stipple,  ts_x_origin,  and  ts_y_ 
origin. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text ,  and  Chapter  5, 
The  Graphics  Context. 

Structures 

typedef  struct  { 
short  x,  y; 

unsigned  short  width,  height; 

}  XRectangle; 

Errors 

BadDrawable 

BadGC 

BadMatch 

Related  Commands 

XClearArea,  XClearWindow,  XCopyArea,  XCopyPlane,  XDraw,  XDrawArc, 
XDrawArcs,  XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc,  XFillArcs, 
XFillPolygon,  XFillRectangle,  XFillRectangles. 
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XFindContext 


/ 


Name 

XFindContext  —  get  data  from  the  context  manager  (not  graphics  context). 

Synopsis 

int  XFindContext ( display,  w,  context,  data) 

Display  *  display ; 

Window  w; 

XContext  context ; 

caddr_t  *data;  /*  RETURN  */ 

Arguments 

di  spl  ay 
w 

context 
data 

Description 

XFindContext  gets  data  that  has  been  assigned  to  the  specified  window  and  context  ID.  The 
context  manager  is  used  to  associate  data  with  windows  for  use  within  an  application. 

This  application  should  have  called  XUniqueContext  to  get  a  unique  ID,  and  then  XSave- 
Context  to  save  the  data  into  the  array.  The  meaning  of  the  data  is  indicated  by  the  context 
ID,  but  is  completely  up  to  the  client. 

XFindContext  returns  xcnoent  (a  nonzero  error  code)  if  the  context  could  not  be  found  and 
zero  (0)  otherwise. 

For  more  information  on  the  context  manager,  see  Volume  One,  Chapter  13,  Other  Program¬ 
ming  Techniques. 

Structures 

typedef  int  XContext; 

Related  Commands 

XDeleteContext, XSaveContext, XUniqueContext. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  window  with  which  the  data  is  associated. 

Specifies  the  context  type  to  which  the  data  corresponds. 

Returns  the  data. 
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XFlush 


Xlib  -  Output  Buffer— 


\ 


Name 

XFlush  —  flush  the  request  buffer  (display  all  queued  requests). 

Synopsis 

XFlush  ( display) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

Description 

XFlush  sends  to  the  server  (“flushes”)  all  requests  that  have  been  buffered  but  not  yet  sent. 

Flushing  is  done  automatically  when  input  is  read  if  no  matching  events  are  in  Xlib’s  queue 
(with  XPending,  XNext Event,  or  XWindowEvent,  etc.),  or  when  a  call  is  made  that  gets 
information  from  the  server  (such  as  XQueryPointer,  XGetFontlnfo)  so  XFlush  is  sel¬ 
dom  needed.  It  is  used  when  the  buffer  must  be  flushed  before  any  of  these  calls  are  reached. 

For  more  information,  see  Volume  One,  Chapter  2,  X  Concepts,  and  Chapter  3,  Basic  Window 
Program. 

Related  Commands 

XSync. 
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XForceScreenSaver 


/ 


Name 

XForceScreenSaver  —  turn  the  screen  saver  on  or  off. 

Synopsis 

XForceScreenSaver (  display ,  mode) 

Display  *display ; 
int  mode; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

mode  Specifies  whether  the  screen  saver  is  active  or  reset.  The  possible  modes  are: 

ScreenSaverActive  or  ScreenSaverReset. 

Description 

XForceScreenSaver  resets  or  activates  the  screen  saver. 

If  the  specified  mode  is  ScreenSaverActive  and  the  screen  saver  currently  is  disabled,  the 
screen  saver  is  activated,  even  if  the  screen  saver  had  been  disabled  by  calling  XSetScreen- 
Saver  with  a  timeout  of  zero  (0).  This  means  that  the  screen  may  go  blank  or  have  some  ran¬ 
dom  change  take  place  to  save  the  phosphors. 

If  the  specified  mode  is  ScreenSaverReset  and  the  screen  saver  currently  is  enabled,  the 
screen  is  returned  to  normal,  the  screen  saver  is  deactivated  and  the  activation  timer  is  reset  to 
its  initial  state  (as  if  device  input  had  been  received).  Expose  events  may  be  generated  on  all 
visible  windows  if  the  server  cannot  save  the  entire  screen  contents. 

For  more  information  on  the  screen  saver,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Errors 

BadValue 

Related  Commands 

XActivateScreenSaver, XGetScreenSaver, XResetScreenSaver, XSet- 
ScreenSaver. 
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XFree 


Xlib  -  HouseKeeping  — 


\ 


Name 

XFree  —  free  specified  memory  allocated  by  an  Xlib  function. 

Synopsis 

XFree ( data) 

caddr_t  data ; 

Arguments 

data  Specifies  a  pointer  to  the  data  that  is  to  be  freed. 

Description 

XFree  is  a  general  purpose  routine  for  freeing  memory  allocated  by  Xlib  calls. 

Related  Commands 

Def aultScreen, XCloseDisplay,  XNoOp,  XOpenDisplay. 
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XFreeColormap 


/ 


Name 

XFreeColormap  —  delete  a  colormap  and  install  the  default  colormap. 

Synopsis 

XFreeColormap  ( display,  cmap) 

Display  ^display ; 

Colormap  cmap; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
cmap  Specifies  the  colormap  to  delete. 

Description 

XFreeColormap  destroys  the  specified  colormap,  unless  it  is  the  default  colormap  for  a 
screen.  That  is,  it  not  only  uninstalls  cmap  from  the  hardware  colormap  if  it  is  installed,  but 
also  frees  the  associated  memory  including  the  colormap  ID. 

XFreeColormap  performs  the  following  processing: 

•  If  cmap  is  an  installed  map  for  a  screen,  it  uninstalls  the  colormap  and  installs  the  default 
if  not  already  installed. 

•  If  cmap  is  defined  as  the  colormap  attribute  for  a  window  (by  XCreateWindow  or 
XChangeWindowAttributes),  it  changes  the  colormap  attribute  for  the  window  to 
the  constant  None,  generates  a  ColormapNotify  event,  and  frees  the  colormap.  The 
colors  displayed  with  a  colormap  of  None  are  server-dependent,  since  the  default  color- 
map  is  normally  used. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadColormap 

Related  Commands 

Def aultColormap, DisplayCells, XCopyColormapAndFree, XCreate- 
Colormap,  XGetStandardColormap,  XInstallColormap,  XList Installed- 
Colormaps,  XSetStandardColormap, XSetWindowColormap, XUninstall- 
Colormap. 
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XFreeColors 


Xlib  -  Color  Cells— 


\ 


Name 

XFreeColors  —  free  colormap  cells  or  planes. 

Synopsis 

XFreeColors ( display,  cmap ,  pixels,  npixels,  planes) 
Display  ^display ; 

Colormap  cmap; 
unsigned  long  pixels[]; 


int 

npixels ; 

unsigned  long  planes; 

Arguments 

di  spl  ay 

Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

cmap 

Specifies  the  colormap. 

pixels 

Specifies  an  array  of  pixel  values. 

npixels 

Specifies  the  number  of  pixels. 

planes 

Specifies  the  planes  you  want  to  free. 

Description 

XFreeColors  frees  the  cells  whose  values  are  computed  by  ORing  together  subsets  of  the 
planes  argument  with  each  pixel  value  in  the  pixels  array. 

If  the  cells  are  read/write,  they  become  available  for  reuse,  unless  they  were  allocated  with 
XAllocColorPlanes,  in  which  case  all  the  related  pixels  may  need  to  be  freed  before  any 
become  available. 

If  the  cells  were  read-only,  they  become  available  only  if  this  is  the  last  client  to  have  allocated 
those  shared  cells. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadAccess  Attempt  to  free  a  colorcell  not  allocated  by  this  client  (either  unallocated  or 
allocated  by  another  client). 

BadColormap 

BadValue  A  pixel  value  is  not  a  valid  index  into  cmap. 

Note:  if  more  than  one  pixel  value  is  in  error,  the  one  reported  is  arbitrary. 

Related  Commands 

BlackPixel, WhitePixel, XAllocColor,  XAllocColorCells, XAllocColor¬ 
Planes,  XAllocNamedColor, XLookupColor, XParseColor, XQueryColor, 
XQueryColors, XStoreColor, XStoreColors,  XStoreNamedColor. 
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XFreeCursor 


/ 


Name 

XFreeCursor  —  release  a  cursor. 

Synopsis 

XFreeCursor ( display,  cursor) 
Display  *  display ; 

Cursor  cursor; 


Arguments 

displ  ay 

Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

cursor 

Specifies  the  ID  of  the  cursor  to  be  affected. 

Description 

XFreeCursor  deletes  the  association  between  the  cursor  ID  and  the  specified  cursor.  The 
cursor  storage  is  freed  when  all  other  clients  have  freed  it.  Windows  with  their  cursor  attribute 
set  to  this  cursor  will  have  this  attribute  set  to  None  (which  implies  CopyFromParent).  The 
specified  cursor  ID  should  not  be  referred  to  again. 

Errors 

BadCursor 

Related  Commands 

XCreateFontCursor,  XCreateGlyphCursor,  XCreatePixmapCursor, XDef ine- 
Cursor,  XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndef ine- 
Cursor. 
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XFreeExtensionList 


Xlib  -  Extensions — 


\ 


Name 

XFreeExtensionList  —  free  memory  allocated  for  a  list  of  installed  extensions. 

Synopsis 

XFreeExtensionList ( list ) 
char  **Iist; 


Arguments 

list 

Specifies  a  pointer  to  the  list  of  extensions  returned  from  XList 
Extensions. 

Description 

XFreeExtensionList  frees  the  memory  allocated  by  XListExtensions. 

For  more  information,  see  Volume  One,  Chapter  13,  Other  Programming  Techniques. 

Related  Commands 

XListExtensions, XQueryExtension. 
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XFreeFont 


/ 


Name 

XFreeFont  —  unload  a  font  and  free  storage  for  the  font  structure. 

Synopsis 

XFreeFont  ( display,  font_struct) 

Display  ^display ; 

XFontStruct  * font_struct ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 
font_struct  Specifies  the  storage  associated  with  the  font. 

Description 

XFreeFont  frees  the  memory  allocated  for  the  font_struct  font  information  structure 
(XFontStruct)  filled  by  XQueryFont  or  XLoadQueryFont.  XFreeFont  frees  all  stor¬ 
age  associated  with  the  font_struct  argument.  Neither  the  data  nor  the  font  should  be  ref¬ 
erenced  again. 

The  server  unloads  the  font  itself  if  no  other  client  has  loaded  it. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

typedef  struct  { 

XExtData  *ext_data; 

Font  fid; 

unsigned  direction; 
unsigned  min_char_or_byte2; 
unsigned  max_char_or_byte2; 
unsigned  min_bytel; 
unsigned  max_bytel; 

Bool  all_chars_exist ; 
unsigned  default_char; 
int  n_properties; 

XFontProp  *properties; 

XCharStruct  min_bounds; 

XCharStruct  max_bounds; 

XCharStruct  *per_char; 
int  ascent; 
int  descent; 

}  XFontStruct; 

Errors 

BadFont 

Related  Commands 

XCreateFontCursor, XFreeFont Inf o,  XFreeFontNames, XFreeFontPath, 
XGetFontPath, XGetFontProperty, XListFonts,  XListFontsWithlnf o, 
XLoadFont,  XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath, 
XUnloadFont. 


/*  hook  for  extension  to  hang  data  */ 

/*  Font  ID  for  this  font  */ 

/*  hint  about  direction  the  font  is  painted  */ 

/*  first  character  */ 

/*  last  character  */ 

/*  first  row  that  exists  */ 

/*  last  row  that  exists  */ 

/*  flag  if  all  characters  have  nonzero  size*/ 

/*  char  to  print  for  undefined  character  */ 

/*  how  many  properties  there  are  */ 

/*  pointer  to  array  of  additional  properties*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  first_char  to  last_char  information  */ 

/*  logical  extent  above  baseline  for  spacing  */ 
/*  logical  descent  below  baseline  for  spacing  */ 
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XFreeFontlnfo 


Xlib  -  Fonts — 


\ 


Name 

XFreeFontlnfo  —  free  the  memory  allocated  by  XListFontsWithlnf  o. 

Synopsis 

XFreeFontlnfo (names,  info,  actual_count) 
char  ** names; 

XFontStruct  *info; 
int  actual_count ; 

Arguments 

names  Specifies  a  pointer  to  the  list  of  font  names  that  were  returned  by  XList¬ 

FontsWithlnf  o. 

info  Specifies  a  pointer  to  the  list  of  font  information  that  was  returned  by 

XListFontsWithlnfo. 

actual_count 

Specifies  the  number  of  matched  font  names  returned  by  XListFonts¬ 
Withlnfo. 


Description 

XFreeFontlnfo  frees  the  list  of  font  information  structures  allocated  by  XListFonts¬ 
Withlnfo.  It  does  not  unload  the  specified  fonts  themselves. 

Structures 

typedef  struct  { 

XExtData  *ext_data; 

Font  fid; 

unsigned  direction; 
unsigned  min_char_or_byte2; 
unsigned  max_char_or_byte2; 
unsigned  min_bytel; 
unsigned  max_bytel; 

Bool  all_chars_exist ; 
unsigned  default_char; 
int  n_properties; 

XFontProp  *properties; 

XCharStruct  min_bounds; 

XCharStruct  max_bounds; 

XCharStruct  *per_char; 
int  ascent; 
int  descent; 

}  XFontStruct; 

Related  Commands 

XCreateFontCursor, XFreeFont,  XFreeFontNames, XGetFontPath, XGetFont- 
Property, XListFonts,  XListFontsWithlnfo, XLoadFont,  XLoadQueryFont, 
XQueryFont, XSetFont,  XSetFontPath, XUnloadFont. 


/*  hook  for  extension  to  hang  data  */ 

/*  Font  ID  for  this  font  */ 

/*  hint  about  direction  the  font  is  painted  */ 

/*  first  character  */ 

/*  last  character  */ 

/*  first  row  that  exists  */ 

/*  last  row  that  exists  */ 

/*  flag  if  all  characters  have  nonzero  size*/ 

/*  char  to  print  for  undefined  character  */ 

/*  how  many  properties  there  are  */ 

/*  pointer  to  array  of  additional  properties*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  first_char  to  last_char  information  */ 

/*  logical  extent  above  baseline  for  spacing  */ 
/*  logical  descent  below  baseline  for  spacing  */ 


200 


Xlib  Reference  Manual 
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XFreeFontNames 


/ 


Name 

XFreeFontNames  —  free  the  memory  allocated  by  XListFonts. 

Synopsis 

XFreeFontNames (list) 
char  *list  [  ]  ; 

Arguments 

list  Specifies  the  array  of  font  name  strings  to  be  freed. 

Description 

XFreeFontNames  frees  the  array  of  strings  returned  by  XListFonts. 

Related  Commands 

XCreateFontCursor, XFreeFont, XFreeFont Inf o,  XFreeFontPath, XGetFont- 
Path,  XGetFontProperty, XListFonts,  XListFontsWithlnf o, XLoadFont, 
XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath,  XUnloadFont. 
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XFreeFontPath 


Xlib  -  Fonts — 


\ 


Name 

XFreeFontPath  —  free  the  memory  allocated  by  XGetFontPath. 

Synopsis 

XFreeFontPath (list) 
char  **list ; 

Arguments 

list  Specifies  an  array  of  strings  allocated  by  XGetFontPath. 

Description 

XFreeFontPath  frees  the  data  used  by  the  array  of  pathnames  returned  by  XGetFont¬ 
Path. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Related  Commands 

XCreateFontCursor, XFreeFont,  XFreeFontlnf o, XFreeFontNames, XGet¬ 
FontPath,  XGetFontProperty, XListFonts,  XListFontsWithlnf o, XLoad- 
Font,  XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath, XUnloadFont. 
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XFreeGC 


/ 


Name 

XFreeGC  —  free  a  graphics  context. 

Synopsis 

XFreeGC  ( display,  gc) 

Display  * display ; 

GC  gc; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
gc  Specifies  the  graphics  context  to  be  freed. 

Description 

XFreeGC  frees  all  memory  associated  with  a  graphics  context,  and  removes  the  GC  from  the 
server  and  display  hardware. 

For  more  information,  see  Volume  One,  Chapter  5,  The  Graphics  Context. 

Errors 

BadGC 

Related  Commands 

Def  aultGC,  XChangeGC,  XCopyGC,  XCreateGC,  XGContextFromGC,  XSetArcMode, 
XSetBackground, XSetClipMask,  XSetClipOrigin,  XSetClipRectangles, 
XSetDashes,  XSetFillRule, XSetFillStyle, XSetForeground, XSet- 
Function,  XSetGraphicsExposures, XSetLineAttributes,  XSetPlaneMask, 
XSetState, XSetStipple,  XSetSubwindowMode,  XSetTSOrigin. 
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XFreeModifiermap 


Xlib  -  Keyboard  — 


\ 


Name 

XFreeModifiermap  —  destroy  and  free  a  keyboard  modifier  mapping  structure. 

Synopsis 

XFreeModifiermap  ( modmap ) 

XModif ierKeymap  *modmap ; 


Arguments 

modmap  Specifies  a  pointer  to  the  XModif  ierKeymap  structure  to  be  freed. 

Description 

XFreeModifiermap  frees  an  XModif  ierKeymap  structure  originally  allocated  by  XNew- 
Modif  ierMap  or  XGetModif  ierMapping. 

For  more  information,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Structures 

typedef  struct  { 

int  max_keypermod;  /*  server's  max  number  of  keys  per  modifier  */ 
KeyCode  *modif iermap;  /*  an  8  by  max_keypermod  array  of 

*  keycodes  to  be  used  as  modifiers  */ 

}  XModif ierKeymap; 

Related  Commands 

XChangeKeyboardMapping,  XDeleteModif  iermapEntry,  XGetKeyboard- 
Mapping,  XGetModif ierMapping, XInsertModif iermapEntry, XKeycode- 
ToKeysym,  XKeysymToKeycode, XKeysymToString,  XLookupKeysym,  XLookup- 
String,  XNewModif  ierMap,  XQueryKeymap,  XRebindKeySym,  XRef  resh- 
KeyboardMapping, XSetModif ierMapping,  XStringToKeysym. 
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—  Xlib  -  Pixmaps  and  Tiles 


XFreePixmap 


/ 


Name 

XFreePixmap  —  free  a  pixmap  ID. 

Synopsis 

XFreePixmap  ( display,  pixmap) 
Display  ^display ; 

Pixmap  pixmap; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

pixmap  Specifies  the  pixmap  whose  ID  should  be  freed. 

Description 

XFreePixmap  disassociates  a  pixmap  ID  from  its  resource.  If  no  other  client  has  an  ID  for 
that  resource,  it  is  freed.  The  Pixmap  should  never  be  referenced  again  by  this  client.  If  it  is, 
the  ID  will  be  unknown  and  a  BadPixmap  error  will  result. 

Errors 

BadPixmap 


Related  Commands 

XCreateBitmapFromData,  XCreatePixmap,  XCreatePixmapFromBitmapData, 
XQueryBestSize, XQueryBestStipple, XQueryBestTile, XReadBitmapFile, 
XSetTile, XSetWindowBackgroundPixmap,  XSetWindowBorderPixmap, 
XWriteBitmapFile. 
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XFreeStringList 


Xlib  -  Window  Manager  Hints— 


\ 


Name 

XFreeStringList  —  free  the  in-memory  data  associated  with  the  specified  string  list. 

Synopsis 

void  XFreeStringList (list) 
char 


Arguments 

list  Specifies  the  list  of  strings  to  be  freed. 

Availability 

Release  4  and  later. 

Description 

XFreeStringList  releases  memory  allocated  by  XTextPropertyToStringList. 

Related  Commands 

XGetTextProperty,  XSetTextProperty,  XStringListToTextProperty, 
XTextPropertytoStringList. 
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—  Xlib  -  Graphics  Context 


XGContextFromGC 


/ 


Name 

XGContextFromGC  —  obtain  the  GContext  (resource  ID)  associated  with  the  specified 
graphics  context. 

Synopsis 

GContext  XGContextFromGC ( gc) 

GC  gc ; 

Arguments 

gc  Specifies  the  graphics  context  of  the  desired  resource  ID. 

Description 

XGContextFromGC  extracts  the  resource  ID  from  the  GC  structure.  The  GC  structure  is 
Xlib’s  local  cache  of  GC  values  and  contains  a  field  for  the  GContext  ID.  This  function  is 
essentially  a  macro  that  accesses  this  field,  since  the  GC  structure  is  intended  to  be  opaque. 

A  GContext  is  needed  to  set  a  field  of  the  xvisuallnfo  structure  prior  to  calling  XGet- 
Visuallnf o. 

Related  Commands 

Def aultGC,  XChangeGC, XCopyGC,  XCreateGC, XFreeGC, XSetArcMode, XSet- 
Background,  XSetClipMask, XSetClipOrigin,  XSetClipRectangles, XSet- 
Dashes,  XSetFillRule, XSetFillStyle,  XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes,  XSetPlaneMask,  XSetState, 
XSetStipple, XSetSubwindowMode, XSetTSOrigin. 
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XGeometry 


Xlib  -  Standard  Geometry— 


\ 


Name 

XGeometry  —  calculate  window  geometry  given  user  geometry  string  and  default  geometry. 


Synopsis 

int  XGeometry ( display,  screen,  user_geom,  default_geom ,  bwidth , 
f width,  f height ,  xadder,  y adder,  x,  y,  width,  height) 
Display  ^display; 
int  screen; 

char  *u ser_geom,  *default_geom ; 
unsigned  int  bwidth ; 
unsigned  int  f width ,  f height ; 
int  xadder,  y adder; 

int  *x,  *y,  *  width,  *  height ;  /  *  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

screen  Specifies  which  screen  the  window  is  on. 

user_geom  Specifies  the  user  or  program  supplied  geometry  string,  perhaps  incomplete. 
default_geom 

Specifies  the  default  geometry  string  and  must  be  complete. 
bwidth  Specifies  the  border  width. 

f height  Specify  the  font  height  and  width  in  pixels  (increment  size). 

f  width 

xadder  Specify  additional  interior  padding  in  pixels  needed  in  the  window. 

yadder 

x  Return  the  user-specified  or  default  coordinates  of  the  window. 

y 

width  Return  the  window  dimensions  in  pixels. 

height 

Description 

XGeometry  has  been  superseded  by  XWMGeometry  as  of  Release  4. 

XGeometry  returns  the  position  and  size  of  a  window  given  a  user-supplied  geometry 
(allowed  to  be  partial)  and  a  default  geometry.  Each  user-supplied  specification  is  copied  into 
the  appropriate  returned  argument,  unless  it  is  not  present,  in  which  case  the  default  specifica¬ 
tion  is  used.  The  default  geometry  should  be  complete  while  the  user-supplied  one  may  not  be. 

XGeometry  is  useful  for  processing  command  line  options  and  user  preferences.  These  geom¬ 
etry  strings  are  of  the  form: 


=<width>x<height> { +- } <xoffset> { +- } <yoffset> 
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Xlib  -  Standard  Geometry 


(continued) 


XGeometry 


The  “=”  at  the  beginning  of  the  string  is  now  optional.  (Items  enclosed  in  <>  are  integers,  and 
items  enclosed  in  {}  are  a  set  from  which  one  item  is  to  be  chosen.  Note  that  the  brackets 
should  not  appear  in  the  actual  string.) 

The  XGeometry  return  value  is  a  bitmask  that  indicates  which  values  were  present  in 
user_geom.  This  bitmask  is  composed  of  the  exclusive  OR  of  the  symbols  XValue, 
YValue,  WidthValue,  HeightValue,  XNegative,  or  YNegative. 

If  the  function  returns  either  XValue  or  YValue,  you  should  place  the  window  at  the 
requested  position.  The  border  width  ( bwidth ),  size  of  the  width  and  height  increments  (typi¬ 
cally  fwidth  and  f height),  and  any  additional  interior  space  (xadder  and  yadder)  are 
passed  in  to  make  it  easy  to  compute  the  resulting  size. 

Related  Commands 

XParseGeometry, XTranslateCoordinates,  XWMGeometry. 
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XGetAtomName 


Xlib  -  Properties — 


\ 


Name 

XGetAtomName  —  get  a  string  name  for  a  property  given  its  atom. 

Synopsis 

char  * XGet At omName  (  display,  atom) 

Display  * display ; 

Atom  atom; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

atom  Specifies  the  atom  whose  string  name  you  want  returned. 

Description 

An  atom  is  a  number  identifying  a  property.  Properties  also  have  a  string  name.  XGetAtom¬ 
Name  returns  the  string  name  that  was  specified  in  the  original  call  to  XInternAtom  that 
returned  this  atom,  or,  for  predefined  atoms,  a  string  version  of  the  symbolic  constant  without 
the  XA_  is  returned.  If  the  specified  atom  is  not  defined,  XGetAtomName  returns  null,  and 
generates  a  B a dA tom  error. 

For  example,  XGetAtomName  returns  "XA_WM_CLASS"  (a  string)  when  passed  the  prede¬ 
fined  atom  xa_wm_clas s  (a  defined  constant). 

You  should  free  the  resulting  string  with  XFree  when  it  is  no  longer  needed. 

XInternAtom  performs  the  inverse  function,  returning  the  atom  given  the  string. 

Errors 

BadAtom 

Related  Commands 

XChangeProperty, XDeleteProperty, XGetFontProperty, XGetWindow- 
Property, XInternAtom,  XListProperties,  XRotateWindowProperties, 
XSetStandardProperties. 
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—  Xlib  -  Window  Manager  Hints 


XGetClassHint 


/ 


Name 

XGetClassHint  —  get  the  xa  wm  class  property  of  a  window. 

Synopsis 

Status  XGetClassHint ( display,  wr  class_hints) 

Display  * display ; 

Window  w; 

XClassHint  *class_hints ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  ID  of  the  window  for  which  the  property  is  desired. 

class_hints  Returns  the  XClassHints  structure. 

Description 

XGetClassHint  obtains  the  xa_wm_class  property  for  the  specified  window.  This  property 
stores  the  resource  class  and  instance  name,  that  the  window  manager  uses  to  get  any  resource 
settings  that  may  control  how  the  window  manager  manages  the  application  that  set  this  prop¬ 
erty.  XGetClassHint  returns  a  Status  of  zero  on  failure,  nonzero  on  success. 

The  XClassHint  structure  returned  contains  res_class,  which  is  the  name  of  the  client 
such  as  “emacs”,  and  res_name,  which  should  be  the  first  of  the  following  that  applies: 

•  command  line  option  (- rn  name ) 

•  a  specific  environment  variable  (e.g.,  RESOURCE_NAME) 

•  the  trailing  component  of  argv  [  0  ]  (after  the  last  /) 

To  free  res_name  and  res_class  when  finished  with  the  strings,  use  XFree. 

For  more  information  on  using  hints,  see  Volume  One,  Chapter  10 .Inter client  Communication. 

Structures 

typedef  struct  { 

char  *res_name; 
char  *res_class; 

}  XClassHint; 

Errors 

BadWindow 

Related  Commands 

XAllocClassHint,  XFetchName,  XGetlconName,  XGetlconSizes,  XGetNormal- 
Hints,  XGetSizeHints,  XGetTransientForHint, XGetWMHints, XGetZoom- 
Hints,  XSetClassHint, XSetCommand, XSetlconName,  XSetlconSizes, XSet- 
NormalHints, XSetSizeHints, XSetTransientForHint,  XSetWMHints,  XSet- 
ZoomHints, XStoreName, XSetWMProperties,  XSetWMProperties. 
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XGetCommand 


-Xlib  -  Window  Manager  Hints — 


Name 

XGetCommand  —  get  the  xa  wm  command  property  (command  line  arguments). 

Synopsis 

Status  XGetCommand  ( display,  w,  argv_return,  argc_return) 
Display  ^display ; 

Window  w; 

char  ***argv_return ; 
int  * argc_return ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  window. 

argv_return  Returns  the  application’s  argument  list. 
argc_return  Returns  the  number  of  arguments  returned. 


Description 

XGetCommand  reads  the  xa_wm_command  property  from  the  specified  window  and  returns  a 
string  list.  If  the  XA  WM  COMMAND  property  exists,  it  is  of  type  xa_string  and  format  8.  If  suf¬ 
ficient  memory  can  be  allocated  to  contain  the  string  list,  XGetCommand  fills  in  the 
argv_return  and  argc_return  arguments  and  returns  a  non-zero  status.  Otherwise,  it 
returns  a  zero  status.  To  free  the  memory  allocated  to  the  string  list,  use  XFreeStringList. 

Errors 

BadWindow 


Related  Commands 

XFetchName,  XGetClassHint, XGetlconName, XGetlconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGetZoom- 
Hints, XSetClassHint, XSetlconName, XSetlconSizes,  XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints,  XSetZoomHints, 
XStoreName. 
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—  Xlib  -  User  Preferences 


XGetDefault 


/ 


Name 

XGetDefault  —  extract  an  option  value  from  the  resource  database. 


Synopsis 

char  ^XGetDefault  (display,  program ,  option) 
Display  * display ; 
char  *  program; 
char  * option; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

program  Specifies  the  program  name  to  be  looked  for  in  the  resource  database.  The  pro¬ 

gram  name  is  usually  argv  [  0  ] ,  the  first  argument  on  the  UNIX  command  line. 

option  Specifies  the  option  name  or  keyword.  Lines  containing  both  the  program 
name  and  the  option  name,  separated  only  by  a  period  or  asterisk,  will  be 
matched. 

Description 

XGetDefault  returns  a  character  string  containing  the  user’s  default  value  for  the  specified 
program  name  and  option  name.  XGetDefault  returns  NULL  if  no  key  can  be  found  that 
matches  option  and  program.  For  a  description  of  the  matching  rules,  see  XrmGet- 
Re  source. 

The  strings  returned  by  XGetDefault  are  owned  by  Xlib  and  should  not  be  modified  or  freed 
by  the  client. 

Lines  in  the  user’s  resource  database  look  like  this: 


xterm . foreground : 
xterm . geometry : 
xterm . saveLines : 
xterm. font : 
xterm. keyMapFile : 
xterm. activelcon : 
xmh . header . font 


tcOcOff 

=81x28 

256 

8x13 

/usr/black/ . keymap 
on 

9x15 


The  portion  on  the  left  is  known  as  a  key;  the  portion  on  the  right  is  the  value.  Upper  or  lower 
case  is  important  in  keys.  The  convention  is  to  capitalize  only  the  second  and  successive  words 
in  each  option,  if  any. 

Resource  specifications  are  usually  loaded  into  the  xa_resource_manager  property  on  the 
root  window  at  login.  If  no  such  property  exists,  a  resource  file  in  the  user’s  home  directory  is 
loaded.  On  a  UNIX-based  system,  this  file  is  $HOMElXdefaults.  After  loading  these  defaults, 
XGetDefault  merges  additional  defaults  specified  by  the  XENVIRONMENT  environment 
variable.  If  XENVIRONMENT  is  defined,  it  contains  a  full  path  name  for  the  additional  resource 
file.  If  XENVIRONMENT  is  not  defined,  XGetDefault  looks  for  $H O  ME  I X  defaults- name, 
where  name  specifies  the  name  of  the  machine  on  which  the  application  is  running. 
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XGetDefault 


(continued) 


Xlib  -  User  Preferences 


The  first  invocation  of  XGetDefault  reads  and  merges  the  various  resource  files  into  Xlib  so 
that  subsequent  requests  are  fast  Therefore,  changes  to  the  resource  files  from  the  program 
will  not  be  felt  until  the  next  invocation  of  the  application. 

For  more  information,  see  Volume  One,  Chapter  11,  Managing  User  Preferences. 

Related  Commands 

XAutoRepeatOf  f ,  XAutoRepeatOn,  XBell,  XChangeKeyboardControl,  XGet- 
KeyboardControl, XGetPointerControl. 
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—  Xlib  -  Error  Handling 


XGetErrorDatabaseText 


/ 


Name 

XGetErrorDatabaseText  —  obtain  error  messages  from  the  error  database. 

Synopsis 

XGetErrorDatabaseText ( display,  name,  message, 
default_string ,  buffer,  length) 

Display  display ; 
char  *name,  * message ; 
char  *default_string ; 

char  *  buffer;  /*  RETURN  */ 

int  length; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
name  Specifies  the  name  of  the  application. 

message  Specifies  the  type  of  the  error  message.  One  of  XProtoError,  Xlib- 
Message,  or  XRequestMa  jor  (see  Description  below). 

default_string 

Specifies  the  default  error  message. 

buffer  Returns  the  error  description. 
length  Specifies  the  size  of  the  return  buffer. 

Description 

XGetErrorDatabaseText  returns  a  message  from  the  error  message  database.  Given 
name  and  message  as  keys,  XGetErrorDatabaseText  uses  the  resource  manager  to 
look  up  a  string  and  returns  it  in  the  buffer  argument.  Xlib  uses  this  function  internally  to  look 
up  its  error  messages.  On  a  UNIX-based  system,  the  error  message  database  is  usually 
lusr/lib/Xl  1  /XErrorDB . 

The  name  argument  should  generally  be  the  name  of  your  application.  The  message  argu¬ 
ment  should  indicate  which  type  of  error  message  you  want.  Three  predefined  message  types 
are  used  by  Xlib  to  report  errors: 

XProtoError  The  protocol  error  number  is  used  as  a  string  for  the  message  argument. 
XlibMessage  These  are  the  message  strings  that  are  used  internally  by  Xlib. 
XRequestMa  jor  The  major  request  protocol  number  is  used  for  the  message  argument. 

If  no  string  is  found  in  the  error  database,  XGetErrorDatabaseText  returns  the 
default_string  that  you  specify  to  the  buffer.  The  string  in  buffer  will  be  of  length 
length.  For  more  information,  see  Volume  One,  Chapter  3,  Basic  Window  Program. 

Related  Commands 

XDisplayName, XGetErrorText, XSetAf terFunction, XSetErrorHandler, 
XSetlOErrorHandler, XSynchronize. 
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XGetErrorText 


Xlib  -  Error  Handling  — 


\ 


Name 

XGetErrorText  —  obtain  a  description  of  error  code. 

Synopsis 

XGetErrorText ( display,  code,  buffer,  length) 

Display  * display ; 
int  code ; 

char  *  buffer;  /*  RETURN  */ 

int  length; 

Arguments 

di  spl  ay 

code 
buffer 
length 

Description 

XGetErrorText  obtains  textual  descriptions  of  errors.  XGetErrorText  returns  a  pointer 
to  a  null-terminated  string  describing  the  specified  error  code  with  length  length.  This  string 
is  copied  from  static  data  and  therefore  may  be  freed.  This  routine  allows  extensions  to  the 
Xlib  library  to  define  their  own  error  codes  and  error  strings  that  can  be  accessed  easily. 

For  more  information,  see  Volume  One,  Chapter  3,  Basic  Window  Program. 

Related  Commands 

XDisplayName, XGetErrorDatabaseText, XSetAf terFunction,  XSetError- 
Handler, XSet IOErrorHandler,  XSynchronize. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  error  code  for  which  you  want  to  obtain  a  description. 
Returns  a  pointer  to  the  error  description  text. 

Specifies  the  size  of  the  buffer. 
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—  Xlib  -  Fonts 


XGetFontPath 


/ 


Name 

XGetFontPath  —  get  the  current  font  search  path. 

Synopsis 

char  **XGetFontPath (  display,  npaths ) 

Display  ^display ; 

int  *  npaths;  /*  RETURN  number  of  elements  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

npaths  Returns  the  number  of  strings  in  the  font  path  array. 

Description 

XGetFontPath  allocates  and  returns  an  array  of  strings  containing  the  search  path  for  fonts. 
The  data  in  the  font  path  should  be  freed  when  no  longer  needed. 

Related  Commands 

XCreateFontCursor, XFreeFont, XFreeFontlnf o, XFreeFontNames, XFree- 
FontPath,  XGetFontProperty, XListFonts,  XListFontsWithlnf o, XLoad- 
Font,  XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath,  XUnloadFont. 
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XGetFontProperty 


Xlib  -  Properties — 


\ 


Name 

XGetFontProperty  —  get  a  font  property  given  its  atom. 

Synopsis 

Bool  XGetFontProperty  (  font_struct ,  atom ,  value) 

XFontStruct  * font_struct ; 

Atom  atom; 

unsigned  long  * value;  /*  RETURN  */ 

Arguments 

font_struct  Specifies  the  storage  associated  with  the  font. 

atom  Specifies  the  atom  associated  with  the  property  name  you  want  returned. 

value  Returns  the  value  of  the  font  property. 

Description 

XGetFontProperty  returns  the  value  of  the  specified  font  property,  given  the  atom  for  that 
property.  The  function  returns  False  if  the  atom  was  not  defined,  or  True  if  was  defined. 

There  are  a  set  of  predefined  atoms  for  font  properties  which  can  be  found  in  <Xll/Xatom.h>. 
These  atoms  are  listed  and  described  in  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 
This  set  contains  the  standard  properties  associated  with  a  font.  The  predefined  font  properties 
are  likely  but  not  guaranteed  to  be  present  for  any  given  font. 

See  Volume  One,  Appendix  I,  Logical  Font  Description  Conventions ,  for  more  information  on 
font  properties. 

Structures 

typedef  struct  { 

XExtData  *ext_data; 

Font  fid; 

unsigned  direction; 
unsigned  min_char_or_byte2; 
unsigned  max_char_or_byte2; 
unsigned  min_bytel; 
unsigned  max_bytel; 

Bool  all_chars_exist ; 
unsigned  default_char; 
int  n_properties; 

XFontProp  *properties; 

XCharStruct  min_bounds; 

XCharStruct  max_bounds; 

XCharStruct  *per_char; 
int  ascent; 
int  descent; 

}  XFontStruct; 

Related  Commands 

XChangeProperty, XDeleteProperty, XGetAtomName,  XGetWindowProperty, 
XInternAtom,  XListProperties,  XRotateWindowProperties, XSetStandard- 
Properties. 


/*  hook  for  extension  to  hang  data  */ 

/*  Font  ID  for  this  font  */ 

/*  hint  about  direction  the  font  is  painted  */ 

/*  first  character  */ 

/*  last  character  */ 

/*  first  row  that  exists  */ 

/*  last  row  that  exists  */ 

/*  flag  if  all  characters  have  nonzero  size*/ 

/*  char  to  print  for  undefined  character  */ 

/*  how  many  properties  there  are  */ 

/*  pointer  to  array  of  additional  properties*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  first_char  to  last_char  information  */ 

/*  logical  extent  above  baseline  for  spacing  */ 
/*  logical  descent  below  baseline  for  spacing  */ 
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Name 

XGetGCValues  —  obtain  components  of  a  given  GC  from  Xlib’s  GC  cache. 

Synopsis 

Status  XGetGCValues (display,  gc,  valuemask,  values) 

Display  * display ; 

GC  gc; 

unsigned  long  valuemask ; 

XGCValues  * values;  /*  RETURN  */ 


Arguments 

displ ay 
gc 

valuemask 

values 

Availability 

Release  4  and  later. 

Description 

XGetGCValues  returns  the  components  specified  by  valuemask  for  the  specified  GC.  Note 
that  the  clip  mask  and  dash  list  (represented  by  the  GCClipMask  and  GCDashList  bits, 
respectively,  in  the  valuemask)  cannot  be  requested.  If  the  valuemask  contains  a  valid  set  of 
GC  mask  bits  (any  of  those  listed  in  the  Structures  section  with  the  exception  of  GCClipMask 
and  GCDashList)  and  no  error  occur,  XGetGCValues  sets  the  requested  components  in 
values  and  returns  a  nonzero  status.  Otherwise,  it  returns  a  zero  status. 

For  more  information,  see  Volume  One,  Chapter  5,  The  Graphics  Context. 

Structures 

typedef  struct  { 
int  function; 
unsigned  long  plane_mask; 
unsigned  long  foreground; 
unsigned  long  background; 
int  line_width; 
int  line_style; 
int  cap_style; 
int  join_style; 
int  fill_style; 
int  fill_rule; 
int  arc_mode; 

Pixmap  tile; 

Pixmap  stipple; 
int  ts_x_origin; 


/*  logical  operation  */ 

/*  plane  mask  */ 

/*  foreground  pixel  */ 

/*  background  pixel  */ 

/*  line  width  */ 

/*  LineSolid,  LineOnOf fDash,  LineDoubleDash  */ 

/*  CapNotLast,  CapButt,  CapRound,  CapPro jecting  */ 
/*  JoinMiter,  JoinRound,  JoinBevel  */ 

/*  FillSolid,  FillTiled,  FillStippled  */ 

/*  EvenOddRule,  WindingRule  */ 

/*  ArcPieSlice,  ArcChord  */ 

/*  tile  pixmap  for  tiling  operations  */ 

/*  stipple  1  plane  pixmap  for  stipping  */ 

/*  offset  for  tile  or  stipple  operations  */ 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  GC. 

Specifies  which  components  in  the  GC  are  to  be  returned  in  the  values 
argument.  This  argument  is  the  bitwise  inclusive  OR  of  one  or  more  of  the 
valid  GC  component  mask  bits. 

Returns  the  GC  values  in  the  specified  XGCValues  structure. 
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Xlib  -  Window  Manager  Hints 


(continued) 


int 

ts_y_origin; 

Font  font; 

/*  default  text  font  for  text  operations 

int 

subwindow  mode; 

/*  ClipByChildren,  Includelnferiors  */ 

Bool  graphics_exposures; 

/*  generate  events  on  XCopyArea,  XCopyPl; 

int 

clip_x_origin; 

/*  origin  for  clipping  */ 

int 

clip  y  origin; 

Pixmap  clip_mask; 

/*  bitmap  clipping;  other  calls  for  rect: 

int 

dash_of f set; 

/*  patterned/dashed  line  information  */ 

char  dashes; 

}  XGCValues; 

#def ine 

GCFunction 

(1L«0) 

#def ine 

GCPlaneMask 

(1L«1) 

#def ine 

GCForeground 

(1L«2) 

#def ine 

GCBackground 

(1L«3) 

# define 

GCLineWidth 

(1L«4) 

#def ine 

GCLineStyle 

(1L«5) 

# define 

GCCapStyle 

(1L«6) 

#def ine 

GCJoinStyle 

(1L«7) 

#def ine 

GCFillStyle 

(1L«8) 

#def ine 

GCFillRule 

(1L«9) 

#define 

GCTile 

(1L«10) 

#def ine 

GCStipple 

(1L«11) 

#define 

GCTileStipXOrigin 

(1L«12) 

#def ine 

GCTileStipYOrigin 

(1L«13) 

#def ine 

GCFont 

(1L«14) 

#def ine 

GCSubwindowMode 

(1L«15) 

#def ine 

GCGraphicsExposures 

(1L«16) 

#define 

GCClipXOrigin 

(1L«17) 

# define 

GCClipYOrigin 

(1L<<18) 

#def ine 

GCClipMask 

(1L<<19)  /*  not  valid  in  this  call  */ 

#def ine 

GCDashOf f set 

(1L«20) 

#def ine 

GCDashList 

(1L<<21 )  /*  not  valid  in  this  call  */ 

#def ine 

GCArcMode 

(1L«22 ) 

Related  Commands 

XChangeGC,  XCopyGC,  XCreateGC. 
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XGetGeometry 


/ 


Name 

XGetGeometry  —  obtain  the  current  geometry  of  drawable. 

Synopsis 

Status  XGetGeometry (display,  drawable,  root,  x,  y, 
width,  height,  border_width ,  depth) 

Display  *  display ; 

Drawable  drawable ; 


Window  *root; 

/* 

RETURN 

*/ 

int  *x,  *y; 

/* 

RETURN 

*/ 

unsigned  int  * width,  * height; 

/* 

RETURN 

*/ 

unsigned  int  * border  width; 

/* 

RETURN 

*/ 

unsigned  int  * depth ; 

/* 

RETURN 

*/ 

Arguments 

displ  ay 
drawable 
root 
x 

y 


Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 
Specifies  the  drawable,  either  a  window  or  a  pixmap. 

Returns  the  root  window  ID  of  the  specified  window. 

Return  the  coordinates  of  the  upper- left  pixel  of  the  window’s  border,  relative 
to  its  parent’s  origin.  For  pixmaps,  these  coordinates  are  always  zero. 


width  Return  the  dimensions  of  the  drawable.  For  a  window,  these  return  the  inside 

height  size  (not  including  the  border). 


border_wi  dth 

Returns  the  borderwidth,  in  pixels,  of  the  window’s  border,  if  the  drawable  is  a 
window.  Returns  zero  if  the  drawable  is  a  pixmap. 

depth  Returns  the  depth  of  the  pixmap  or  window  (bits  per  pixel  for  the  object). 


Description 

This  function  gets  the  current  geometry  of  a  drawable,  plus  the  ID  of  the  root  window  of  the 
screen  the  window  is  on. 

XGetGeometry  returns  a  Status  of  zero  on  failure,  or  nonzero  on  success. 


Errors 

BadDrawable 


Related  Commands 

XConf igureWindow, XGetWindowAttributes, XMoveResizeWindow, XMove- 
Window,  XResizeWindow. 
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Xlib  -  Window  Manager  Hints — 


\ 


Name 

XGetlconName  —  get  the  name  to  be  displayed  in  an  icon. 

Synopsis 

Status  XGetlconName  ( displ ay,  w,  icon_name) 

Display  ^display ; 

Window  w; 

char  ** icon_name ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  ID  of  the  window  whose  icon  name  you  want  to  learn. 

icon_name  Returns  a  pointer  to  the  name  to  be  displayed  in  the  window’s  icon.  The 
name  should  be  a  null-terminated  string.  If  a  name  hasn’t  been  assigned  to 
the  window,  XGetlconName  sets  this  argument  to  NULL.  When  finished 
with  it,  a  client  must  free  the  icon  name  string  using  XFree. 

Description 

XGetlconName  is  superseded  by  XGetWMIconName  in  Release  4.  XGetlconName  reads 
the  icon  name  property  of  a  window.  This  function  is  primarily  used  by  window  managers  to 
get  the  name  to  be  written  in  a  window’s  icon  when  they  need  to  display  that  icon. 

XGetlconName  returns  a  nonzero  Status  if  it  succeeds,  and  zero  if  no  icon  name  has  been 
set  for  the  argument  window. 

For  more  information,  see  Volume  One,  Chapter  \0,  Inter  client  Communication. 

Errors 

BadWindow 

Related  Commands 

XFetchName, XGetClassHint, XGetlconSizes, XGetNormalHints, XGetSize- 
Hints,  XGetTransientForHint, XGetWMHints,  XGetZoomHints,  XSetClass- 
Hint,  XSetCommand, XSet IconName, XSetlconSizes, XSetNormalHints, XSet- 
SizeHints,  XSetTransientForHint, XSetWMHints, XSetZoomHints, XStore- 
Name. 
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XGetlconSizes 


/ 


Name 

XGetlconSizes  —  get  preferred  icon  sizes. 

Synopsis 

Status  XGetlconSizes ( display,  w,  size_list,  count) 

Display  ^display ; 

Window  w; 

XlconSize  **size_list ;  /*  RETURN  */ 

int  *  count;  /*  RETURN  */ 

Arguments 

displ  ay 

w 

size_list 
count 

Description 

XGetlconSizes  reads  the  xa_wm_icon_size  property  that  should  be  set  by  the  window 
manager  to  specify  its  desired  icon  sizes.  XGetlconSizes  returns  a  Status  of  zero  if  a 
window  manager  has  not  set  icon  sizes,  and  a  nonzero  Status  otherwise.  This  function 
should  be  called  by  all  programs  to  find  out  what  icon  sizes  are  preferred  by  the  window  man¬ 
ager.  The  application  should  then  use  XSetWMHints  to  supply  the  window  manager  with  an 
icon  pixmap  or  window  in  one  of  the  supported  sizes.  To  free  the  data  allocated  in 
size_list,  use  XFree. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Structures 

typedef  struct  { 

int  min_width,  min_height; 
int  max_width,  max_height; 
int  width_inc,  height_inc; 

}  XlconSize; 

/*  width_inc  and  height_inc  provide  the  preferred 

*  increment  of  sizes  in  the  range  from  min_width 

*  to  max_width  and  min_height  to  max_height.  */ 

Errors 

BadWindow 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  window  ID  (usually  of  the  root  window). 

Returns  a  pointer  to  the  size  list. 

Returns  the  number  of  items  in  the  size  list. 
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(continued) 


Xlib  -  Window  Manager  Hints 


Related  Commands 

XAllocIconSize, XFetchName, XGetClassHint, XGetlconName, XGetNormal- 
Hints,  XGetSizeHints,  XGetTransientForHint, XGetWMHints,  XGetZoom- 
Hints,  XSetClassHint, XSetCommand,  XSetlconSizes,  XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints,  XSetZoomHints, 
XStoreName . 
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XGetlmage 


/ 


Name 

XGetlmage  —  place  contents  of  a  rectangle  from  drawable  into  an  image. 

Synopsis 

Xlmage  *XGet Image ( display,  drawable ,  x,  y,  width ,  height, 
plane_mask,  format) 

Display  ^display ; 

Drawable  drawable; 
int  x,  y; 

unsigned  int  width,  height ; 
unsigned  long  plane_mask ; 
int  format; 


Arguments 

displ  ay 

drawable 

x 

y 

width 

height 

plane_mask 

format 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  drawable  to  get  the  data  from. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle,  rela¬ 
tive  to  the  origin  of  the  drawable. 

Specify  the  width  and  height  in  pixels  of  the  image. 

Specifies  a  plane  mask  that  indicates  which  planes  are  represented  in  the 
image. 

Specifies  the  format  for  the  image.  Pass  either  XYPixmap  or  ZPixmap. 


Description 

XGetlmage  dumps  the  contents  of  the  specified  rectangle,  a  drawable,  into  a  client-side  Xlm¬ 
age  structure,  in  the  format  you  specify.  Depending  on  which  format  you  pass  to  the  format 
argument,  the  function  does  the  following: 


•  If  the  format  is  XYPixmap 

Gets  only  the  bit  planes  you  passed  to  the  plane_mask  argument. 

•  If  the  format  is  ZPixmap 

Sets  to  0  the  bits  in  all  planes  not  specified  in  the  plane_mask  argument.  The  function 
performs  no  range  checking  on  the  values  in  plane_mask ,  and  ignores  extraneous  bits. 

XGetlmage  returns  the  depth  of  the  image  to  the  depth  member  of  the  Xlmage  structure. 
This  depth  is  as  specified  when  the  drawable  was  created. 

If  the  drawable  is  a  pixmap,  the  specified  rectangle  must  be  completely  inside  the  pixmap,  or  a 
BadMatch  error  will  occur,  and  the  visual  field  in  the  image  will  be  None.  If  XGetlmage 
fails,  it  returns  null.  If  the  drawable  is  a  window,  the  window  must  be  viewable,  and  the  speci¬ 
fied  rectangle  must  not  go  off  the  edge  of  the  screen.  Otherwise,  a  BadMatch  error  will  occur. 
If  the  drawable  is  a  window,  the  visual  argument  will  return  the  visual  specified  when  the 
drawable  was  created. 
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(continued) 


Xlib  -  Images 


The  returned  image  will  include  any  visible  portions  of  inferiors  or  overlapping  windows  con¬ 
tained  in  the  rectangle.  The  image  will  not  include  the  cursor.  The  specified  area  can  include 
the  borders.  The  returned  contents  of  visible  regions  of  inferiors  of  different  depth  than  the 
specified  window  are  undefined. 

If  the  window  has  a  backing-store,  the  backing-store  contents  are  returned  for  regions  of  the 
window  that  are  obscured  by  noninferior  windows.  Otherwise,  the  return  contents  of  such 
obscured  regions  are  undefined.  Also  undefined  are  the  returned  contents  of  visible  regions  of 
inferiors  of  different  depth  than  the  specified  window. 

The  data  in  the  image  structure  is  stored  in  the  server’s  natural  byte-  and  bit-order. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadDrawable 

BadMatch  See  Description  above. 

BadValue 

Related  Commands 

ImageByteOrder,  XAddPixel,  XCreatelmage,  XDestroylmage,  XGetPixel, 
XGetSublmage,  XPutlmage,  XPutPixel,  XSublmage. 
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XGetlnputFocus 


/ 


Name 

XGetlnputFocus  —  return  the  current  keyboard  focus  window. 

Synopsis 

XGetlnputFocus (  display,  focus ,  revert_to) 
Display  ^display ; 

Window  *  focus;  /*  RETURN  */ 

int  *  revert_to ;  /*  RETURN  */ 


Arguments 

display 

Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

focus 

Returns  the  ID  of  the  focus  window,  or  one  of  the  constants  PointerRoot 
or  None. 

revert_to 

Returns  the  window  to  which  the  focus  would  revert  if  the  focus  window 
became  invisible.  This  is  one  of  these  constants:  RevertToParent, 
RevertToPointerRoot,  or  RevertToNone.  Must  not  be  a  window  ID. 

Description 

XGetlnputFocus  returns  the  current  keyboard  focus  window  and  the  window  to  which  the 
focus  would  revert  if  the  focus  window  became  invisible. 

XGetlnputFocus  does  not  report  the  last  focus  change  time.  This  is  available  only  from 
Focus  In  and  FocusOut  events. 

Related  Commands 

QLength,  XAllowEvents, XChecklf Event, XCheckMaskEvent, XCheckTyped- 
Event,  XCheckTypedWindowEvent,  XCheckWindowEvent,  XEventsQueued, 
XGetMotionEvents,  XlfEvent,  XMaskEvent,  XNextEvent,  XPeekEvent,  XPeek- 
IfEvent,  XPending, XPutBackEvent, XSelect Input,  XSendEvent,  XSetlnput- 
Focus, XSynchronize, XWindowEvent. 
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Xlib  -  User  Preferences— 


\ 


Name 

XGetKeyboardControl  —  obtain  a  list  of  the  current  keyboard  preferences. 

Synopsis 

XGetKeyboardControl ( display ,  values) 

Display  ^display ; 

XKeyboardState  * values;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
values  Returns  filled  XKeyboardState  structure. 

Description 

XGetKeyboardControl  returns  the  current  control  values  for  the  keyboard.  For  the  LEDs 
(light  emitting  diodes),  the  least  significant  bit  of  led_mask  corresponds  to  LED  1,  and  each 
bit  that  is  set  to  1  in  led_mask  indicates  an  LED  that  is  lit.  auto_repeats  is  a  bit  vector; 
each  bit  that  is  set  to  1  indicates  that  auto-repeat  is  enabled  for  the  corresponding  key.  The  vec¬ 
tor  is  represented  as  32  bytes.  Byte  N  (from  0)  contains  the  bits  for  keys  8N  to  8N+7,  with  the 
least  significant  bit  in  the  byte  representing  key  8N.  global_auto_repeat  is  either 
AutoRepeatModeOn  or  AutoRepeatModeOf  f . 

For  the  ranges  of  each  member  of  XKeyboardState,  see  the  description  of  XChange- 
PointerControl. 

For  more  information,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Structures 

typedef  struct  { 

int  key_click_percent ; 
int  bell_percent; 

unsigned  int  bell_pitch,  bell_duration; 
unsigned  long  led_mask; 
int  global_auto_repeat; 
char  auto_repeats [32] ; 

}  XKeyboardState; 

Related  Commands 

XAutoRepeatOf  f ,  XAutoRepeatOn,  XBell,  XChangeKeyboardControl,  XGet- 
Def ault, XGetPointerControl. 
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XGetKeyboardMapping 


/ 


Name 

XGetKeyboardMapping  —  return  symbols  for  keycodes. 

Synopsis 

KeySym  *XGetKeyboardMapping ( display,  first  keycode, 
keycode_count ,  keysyms _per_keycode) 

Display  ^display ; 

KeyCode  first_keycode ; 
int  keycode_count ; 

int  *  keysyms _per_keycode ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
first_keycode 

Specifies  the  first  keycode  that  is  to  be  returned. 
keycode_count 

Specifies  the  number  of  keycodes  that  are  to  be  returned. 
keysyms _per_keycode 

Returns  the  number  of  keysyms  per  keycode. 

Description 

Starting  with  first_keycode,  XGetKeyboardMapping  returns  the  symbols  for  the 
specified  number  of  keycodes.  The  specified  first_keycode  must  be  greater  than  or  equal 
to  min_keycode  as  returned  by  XDisplayKeycodes,  otherwise  a  BadValue  error 
occurs.  In  addition,  the  following  expression  must  be  less  than  or  equal  to  max_keycode 
(also  returned  by  XDisplayKeycodes)  as  returned  in  the  Display  structure,  otherwise  a 
BadValue  error  occurs: 

first_keycode  +  keycode_count  -  1 

The  number  of  elements  in  the  keysyms  list  is: 

keycode_count  *  keysyms_per_keycode 

Then,  keysym  number  N  (counting  from  0)  for  keycode  K  has  an  index  (counting  from  0)  of  the 
following  (in  keysyms): 

(K  -  first_keycode)  *  keysyms_per_keycode  +  N 

The  keysyms^e^keycode  value  is  chosen  arbitrarily  by  the  server  to  be  large  enough  to 
report  all  requested  symbols.  A  special  KeySym  value  of  NoSymbol  is  used  to  fill  in  unused 
elements  for  individual  keycodes. 

Use  XFree  to  free  the  returned  keysym  list  when  you  no  longer  need  it. 

For  more  information,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 
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(continued) 


Xlib  -  Keyboard 


Errors 

BadValue  first_keycode  less  than  displ ay- >min_keycode . 
displ  ay- >max_keycode  exceeded. 

Related  Commands 

XChangeKeyboardMapping,  XDeleteModif iermapEntry,  XFreeModif iermap, 
XGetModif ierMapping, XInsertModif iermapEntry,  XKeycodeToKeysym, 
XKeysymToKeycode, XKeysymToString, XLookupKeysym,  XLookupString, 
XNewModif  ierMap,  XQueryKeymap,  XRebindKeySym,  XRef  reshKeyboard- 
Mapping,  XSetModif ierMapping, XStringToKeysym. 
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XGetModifierMapping 


/ 


Name 

XGetModifierMapping  —  obtain  a  mapping  of  modifier  keys  (Shift,  Control,  etc.). 

Synopsis 

XModif ierKeymap  *XGetModif ierMapping  (  display ) 

Display  *display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Description 

XGetModifierMapping  returns  the  keycodes  of  the  keys  being  used  as  modifiers. 

There  are  eight  modifiers,  represented  by  the  symbols  ShiftMapIndex,  LockMaplndex, 
ControlMapIndex,  ModlMapIndex,  Mod2MapIndex,  Mod3MapIndex,  Mod4Map- 
Index,  and  Mod5MapIndex.  The  modifiermap  member  of  the  XModif  ierKeymap 
structure  contains  eight  sets  of  keycodes,  each  set  containing  max_keypermod  keycodes. 
Zero  keycodes  are  not  meaningful.  If  an  entire  modifiermap  is  filled  with  zero’s,  the  corre¬ 
sponding  modifier  is  disabled.  No  keycode  will  appear  twice  anywhere  in  the  map. 

Structures 

typedef  struct  { 

int  max_keypermod;  /*  server's  max  number  of  keys  per  modifier  */ 
KeyCode  *modif iermap;  /*  an  8  by  max_keypermod  array  of 

*  keycodes  to  be  used  as  modifiers  */ 

}  XModif ierKeymap ; 

/*  modifier  names.  Used  to  build  a  SetModif ierMapping  request  or 
to  read  a  GetModif ierMapping  request.  */ 

#define  ShiftMapIndex  0 

#define  LockMaplndex  1 

#define  ControlMapIndex  2 

#define  ModlMapIndex  3 

#define  Mod2MapIndex  4 

#define  Mod3MapIndex  5 

#define  ModlMapIndex  6 

tdefine  Mod5MapIndex  7 

Related  Commands 

XChangeKeyboa rdMapping,  XDeleteModif  iermapEntry,  XFreeModif  iermap, 
XGetKeyboardMapping,  XInsertModif  iermapEntry,  XKeycodeToKeysym, 
XKeysymToKeycode,  XKeysymToString,  XLookupKeysym,  XLookupString, 
XNewModif  ierMap,  XQueryKeymap,  XRebindKeySym,  XRef  reshKeyboard- 
Mapping,  XSetModif ierMapping,  XStringToKeysym. 
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Xlib  -  Input  Handling  — 


\ 


Name 

XGetMotionEvents  —  get  events  from  pointer  motion  history  buffer. 

Synopsis 

XTimeCoord  ^XGetMotionEvents ( display,  w,  start ,  stop ,  nevents) 
Display  * display ; 

Window  w ; 

Time  start,  stop; 

int  *  nevents;  /*  RETURN  */ 

Arguments 

display 
w 

start 
stop 

nevents 

Description 

XGetMotionEvents  returns  all  events  in  the  motion  history  buffer  that  fall  between  the 
specified  start  and  stop  times  (inclusive)  and  that  have  coordinates  that  lie  within  (including 
borders)  the  specified  window  at  its  present  placement.  The  x  and  y  coordinates  of  the 
XTimeCoord  return  structure  are  reported  relative  to  the  origin  of  w. 

XGetMotionEvent  returns  NULL  if  the  server  does  not  support  a  motion  history  buffer 
(which  is  common),  or  if  the  start  time  is  after  the  stop  time,  or  if  the  start  time  is  in  the  future. 
A  motion  history  buffer  is  supported  if  XDisplayMotionBuf  ferSize  (display)  >  0.  The 
pointer  position  at  each  pointer  hardware  interrupt  is  then  stored  for  later  retrieval. 

If  the  start  time  is  later  than  the  stop  time,  or  if  the  start  time  is  in  the  future,  no  events  are 
returned.  If  the  stop  time  is  in  the  future,  it  is  equivalent  to  specifying  the  constant  Current - 
Time,  since  the  server  does  not  wait  to  report  future  events. 

Use  XFree  to  free  the  returned  XTimeCoord  structures  when  they  are  no  longer  needed. 

For  more  information,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Structures 

typedef  struct  _XTimeCoord  { 

Time  time; 
short  x,  y; 

}  XTimeCoord; 

Errors 

BadWindow 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 

Specifies  the  ID  of  the  window  whose  associated  pointer  motion  events  will  be 
returned. 

Specify  the  time  interval  for  which  the  events  are  returned  from  the  motion  his¬ 
tory  buffer.  Pass  a  time  stamp  (in  milliseconds)  or  Cur  rent  Time. 

Returns  the  number  of  events  returned  from  the  motion  history  buffer. 
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Xlib- Input  Handling 


(continued) 


XGetMotionEvents 


Related  Commands 

QLength,  XAllowEvents, XChecklfEvent,  XCheckMaskEvent, XCheckTyped- 
Event,  XCheckTypedWindowEvent,  XCheckWindowEvent,  XEventsQueued, 

XGet Input Focus, Xlf Event, XMaskEvent, XNextEvent,  XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelectlnput, XSendEvent, XSetlnput- 
Focus,  XSynchronize, XWindowEvent. 


Xlib  Reference  Manual 


233 


XGetNormalHints 


Xlib  -  Window  Manager  Hints— 


\ 


Name 

XGetNormalHints  —  get  the  size  hints  property  of  a  window  in  normal  state  (not  zoomed  or 
iconified). 


Synopsis 

Status  XGetNormalHints ( display,  w,  hints ) 

Display  ^display ; 

Window  w; 

XSizeHints  *hints;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

w  Specifies  the  ID  of  the  window  to  be  queried. 

hints  Returns  the  sizing  hints  for  the  window  in  its  normal  state. 

Description 

XGetNormalHints  has  been  superseded  by  XGetWMNormalHints  as  of  Release  4, 
because  new  interclient  communication  conventions  are  now  standard. 

XGetNormalHints  returns  the  size  hints  for  a  window  in  its  normal  state  by  reading  the 
xa_wm_normal_h ints  property.  This  function  is  normally  used  only  by  a  window  manager.  It 
returns  a  nonzero  Status  if  it  succeeds,  and  zero  if  it  fails  (e.g.,  the  application  specified  no 
normal  size  hints  for  this  window.) 

For  more  information  on  using  hints,  see  Volume  One,  Chapter  10,  Inter client  Communication. 

Structures 

typedef  struct  { 

long  flags;  /*  which  fields  in  structure  are  defined  */ 
int  x,  y; 

int  width,  height; 
int  min_width,  min_height; 
int  max_width,  max_height; 

int  width_inc,  height_inc; 

struct  { 

int  x;  /*  numerator  */ 

int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 

}  XSizeHints; 


/*  flags  argument  in  size  hints  */ 

#define  USPosition  (1L  «  0)/*  user  specified  x,  y  */ 

#define  USSize  (1L  «  1)/*  user  specified  width,  height  */ 


#define  PPosition 
#define  PSize 
tdefine  PMinSize 
#define  PMaxSize 


(1L  «  2)/*  program  specified  position  */ 

(1L  «  3)/*  program  specified  size  */ 

(1L  «  4)/*  program  specified  minimum  size  */ 
(1L  «  5)/*  program  specified  maximum  size  */ 
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Xlib  -  Window  Manager  Hints 


(continued) 


XGetNormalHints 


tdefine  PResizelnc  (1L  «  6)/*  program  specified  resize  increments  */ 
#define  PAspect  (1L  «  7)/*  program  specified  min/max  aspect  ratios  */ 

#def ine  PAllHints  (PPosition | PSize I PMinSize I PMaxSize I PResizelnc I PAspect) 

Errors 

BadWindow 


Related  Commands 

XFetchName, XGetClassHint, XGetlconName, XGetlconSizes, XGetSize- 
Hints,  XGetTransientForHint,  XGetWMHints,  XGetZoomHints,  XSetClass- 
Hint,  XSetCommand,  XSetlconName,  XSetlconSizes,  XSetNormalHints,  XSet- 
SizeHints,  XSetTransientForHint, XSetWMHints,  XSetZoomHints, XStore- 
Name. 
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XGetPixel 


Xlib  -  Images — 


\ 


Name 

XGetPixel  —  obtain  a  single  pixel  value  from  an  image. 

Synopsis 

unsigned  long  XGetPixel ( ximage,  x,  y) 

Xlmage  * ximage; 
int  x ; 
int  y; 

Arguments 

ximage 

x 

y 

Description 

XGetPixel  returns  the  specified  pixel  from  the  named  image.  The  x  and  y  coordinates  are 

relative  to  the  origin  (upper  left  [0,0])  of  the  image).  The  pixel  value  is  returned  in  the  clients 

bit-  and  byte-order.  The  x  and  y  coordinates  must  be  contained  in  the  image. 

For  more  information,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Structures 

typedef  struct  _XImage  { 
int  width,  height; 
int  xoffset; 
int  format; 
char  *data; 
int  byte_order; 
int  bitmap_unit; 
int  bitmap_bit_order; 
int  bitmap_pad; 
int  depth; 
int  bytes_per_line; 
int  bits_per_pixel; 
unsigned  long  red_mask; 
unsigned  long  green_mask; 
unsigned  long  blue_mask; 
char  *obdata; 
struct  funcs  { 

struct  _XImage  *  (*create_image)  ( )  ; 
int  (*destroy_image) () ; 
unsigned  long  (*get_pixel) () ; 
int  (*put_pixel) (); 
struct  _XImage  * (*sub_image) (); 
int  (*add_pixel) (); 

}  f; 

}  Ximage; 


/*  size  of  image  */ 

/*  number  of  pixels  offset  in  X  direction  */ 
/*  XYBitmap,  XYPixmap,  ZPixmap  */ 

/*  pointer  to  image  data  */ 

/*  data  byte  order,  LSBFirst,  MSBFirst  */ 

/*  quant,  of  scan  line  8,  16,  32  */ 

/*  LSBFirst,  MSBFirst  */ 

/*  8,  16,  32  either  XY  or  ZPixmap  */ 

/*  depth  of  image  */ 

/*  accelerator  to  next  line  */ 

/*  bits  per  pixel  (ZPixmap)  */ 

/*  bits  in  z  arrangment  */ 


/*  hook  for  the  object  routines  to  hang  on  */ 
/*  image  manipulation  routines  */ 


Specifies  a  pointer  to  the  image. 

Specify  the  x  and  y  coordinates  of  the  pixel  whose  value  is  to  be  returned. 
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Xlib  -  Images 


(continued) 


XGetPixel 


Related  Commands 

ImageByteOrder,  XAddPixel,  XCreatelmage,  XDestroy Image,  XGetlmage, 
XGetSublmage,  XPut  Image,  XPutPixel,  XSublmage. 
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XGetPointerControl 


Xlib  -  Pointer — 


\ 


Name 

XGetPointerControl  —  get  the  current  pointer  preferences. 

Synopsis 

XGetPointerControl (  display,  accel_numerator ,  accel_denominator , 
threshold) 

Display  * display ; 

int  *accel_numerator,  * accel_denominator ;  /*  RETURN  */ 

int  * threshold ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
accel_n umerator 

Returns  the  numerator  for  the  acceleration  multiplier. 
accel_denominator 

Returns  the  denominator  for  the  acceleration  multiplier. 

threshold  Returns  the  acceleration  threshold  in  pixels.  The  pointer  must  move  more 
than  this  amount  before  acceleration  takes  effect. 

Description 

XGetPointerControl  gets  the  pointer  acceleration  parameters. 

accel_numerator  divided  by  accel_denominator  is  the  number  of  pixels  the  cursor 
moves  per  unit  of  motion  of  the  pointer,  applied  only  to  the  amount  of  movement  over 
threshold. 

Related  Commands 

XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 
Mapping, XGrabPointer, XQueryPointer,  XSetPointerMapping,  XUngrab- 
Pointer,  XWarpPointer. 
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—  Xlib  -  Pointer 


XGetPointerMapping 


/ 


Name 

XGetPointerMapping  —  get  the  pointer  button  mapping. 

Synopsis 

int  XGetPointerMapping ( display,  map,  nmap) 

Display  * display ; 

unsigned  char  map[];  /*  RETURN  */ 

int  nmap ; 

Arguments 

display 

map 
nmap 

Description 

XGetPointerMapping  returns  the  current  mapping  of  the  pointer  buttons.  Information  is 
returned  in  both  the  arguments  and  the  function’s  return  value,  map  is  an  array  of  the  numbers 
of  the  buttons  as  they  are  currently  mapped.  Elements  of  the  list  are  indexed  starting  from  1. 
The  nominal  mapping  for  a  pointer  is  the  identity  mapping:  map[i]=i.  If  map  [3]  =2,  it 
means  that  the  third  physical  button  triggers  the  second  logical  button. 

nmap  indicates  the  desired  number  of  button  mappings. 

The  return  value  of  the  function  is  the  actual  number  of  elements  in  the  pointer  list,  which  may 
be  greater  or  less  than  nmap. 

Related  Commands 

XChangeActivePointerGrab,  XChangePointerControl,  XGetPointer- 
Control,  XGrabPointer, XQueryPointer,  XSetPointerMapping, XUngrab- 
Pointer,  XWarpPointer. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Returns  the  mapping  list.  Array  begins  with  map  [  ] . 

Specifies  the  number  of  items  in  mapping  list. 
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XGetRG  BColormaps 


Xlib  -  Window  Manager  Hints — 


\ 


Name 

XGetRGBColormaps  —  obtain  the  XStandardColormap  structure  associated  with  the 
specified  property. 


Synopsis 

Status  XGetRGBColormaps ( display,  w,  std_colormap ,  count , 
property) 

Display  ^display ; 

Window  w; 

XStandardColormap  ** std_colormap ;  /*  RETURN  */ 

int  *  count;  /*  RETURN  */ 

Atom  property ; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window. 

std_colormap 

Returns  the  XStandardColormap  structure. 
count  Returns  the  number  of  colormaps. 

property  Specifies  the  property  name. 

Availability 

Release  4  and  later. 

Description 

XGetRGBColormaps  returns  the  RGB  colormap  definitions  stored  in  the  specified  property 
on  the  named  window.  If  the  property  exists,  is  of  type  rgb_color_map  ,  is  of  format  32,  and  is 
long  enough  to  contain  a  colormap  definition,  XGetRGBColormaps  allocates  and  fills  in 
space  for  the  returned  colormaps,  and  returns  a  non-zero  status.  Otherwise,  none  of  the  fields 
are  set,  and  XGetRGBColormaps  returns  a  zero  status.  If  the  visualid  field  is  not  present, 
XGetRGBColormaps  assumes  the  default  visual  for  the  screen  on  which  the  window  is 
located;  if  the  killid  field  is  not  present,  it  is  assumed  to  have  a  value  of  None,  which  indicates 
that  the  resources  cannot  be  released.  Note  that  it  is  the  caller’s  responsibility  to  honor  the 
ICCCM  restriction  that  only  rgb  default  map  contain  more  than  one  definition. 

XGetRGBColormaps  supersedes  XGetStandardColormap. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Structures 

typedef  struct  { 

Colormap  colormap; 
unsigned  long  red_max; 
unsigned  long  red__mult; 
unsigned  long  green_max; 
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Xlib  -  Window  Manager  Hints 

(continued)  XGetRGBColormaps 

unsigned  long  green  mult; 
unsigned  long  blue  max; 
unsigned  long  blue  mult; 
unsigned  long  base_pixel; 
VisuallD  visualid; 

XID  killid; 

}  XStandardColormap; 

/*  added  by  ICCCM  version  1  */ 

/*  added  by  ICCCM  version  1  */ 

Errors 

BadAtom 

BadWindow 

Related  Commands 

XAllocStandardColormap,  XSetRGBColormaps. 
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XGetScreenSaver 


Xllb  -  Screen  Saver  — 


\ 


Name 

XGetScreenSaver  —  get  the  current  screen  saver  parameters. 

Synopsis 

XGetScreenSaver ( display,  timeout,  interval,  prefer_blanking , 
allow_exposures) 

Display  * display ; 

int  * timeout ,  *  interval;  /*  RETURN  */ 
int  *prefer_blanking;  /*  RETURN  */ 

int  * allow_exposures ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
timeout  Returns  the  idle  time,  in  seconds,  until  the  screen  saver  turns  on. 
interval  Returns  the  interval  between  screen  changes,  in  seconds. 
prefer_blanking 

Returns  the  current  screen  blanking  preference,  one  of  these  constants: 
DontPreferBlanking,  Pref  erBlanking,  or  Def  aultBlanking. 

allow_exposures 

Returns  the  current  screen  save  control  value,  either  DontAllow- 
Exposures,  AllowExposures,  or  Def  aultExposures. 


Description 

XGetScreenSaver  returns  the  current  settings  of  the  screen  saver,  which  may  be  set  with 
XSet  Screensaver. 

A  positive  timeout  indicates  that  the  screen  saver  is  enabled.  A  timeout  of  zero  indicates 
that  the  screen  saver  is  disabled. 

If  the  server-dependent  screen  saver  method  supports  periodic  change,  interval  serves  as  a 
hint  about  the  length  of  the  change  period,  and  zero  serves  as  a  hint  that  no  periodic  change 
will  be  made.  An  interval  of  zero  indicates  that  random  pattern  motion  is  disabled. 

For  more  information  on  the  screen  saver,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Related  Commands 

XActivateScreenSaver, XForceScreenSaver, XResetScreenSaver, XSet- 
ScreenSaver. 
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XGetSelectionOwner 


—  Xlib  -  Selections 


/ 


Name 

XGetSelectionOwner  —  return  the  owner  of  a  selection. 

Synopsis 

Window  XGetSelectionOwner (  display,  selection) 

Display  * display ; 

Atom  selection ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

selection  Specifies  the  selection  atom  whose  owner  you  want  returned. 

Description 

XGetSelectionOwner  returns  the  window  ID  of  the  current  owner  of  the  specified  selec¬ 
tion.  If  no  selection  was  specified,  or  there  is  no  owner,  the  function  returns  the  constant  None. 

For  more  information  on  selections,  see  Volume  One,  Chapter  10,  Inter  client  Communication . 

Errors 

BadAtom 

Related  Commands 

XConvert Select ion, XSet Select ionOwner. 


Xlib  Reference  Manual 


243 


XGetSizeHints 


Xlib  -  Window  Manager  Hints— 


Name 

XGetSizeHints  —  read  any  property  of  type  xa_size_hints. 

Synopsis 

Status  XGetSizeHints ( display,  wr  hints ,  property) 
Display  ^display ; 

Window  w; 

XSizeHints  *hints ;  /*  RETURN  */ 

Atom  property ; 

Arguments 

display 
w 

hints 
property 


Description 

XGetSizeHints  has  been  superseded  by  XGetWMSizeHints  as  of  Release  4,  because  the 
interclient  communication  conventions  are  now  standard. 

XGetSizeHints  returns  the  XSizeHints  structure  for  the  named  property  and  the  speci¬ 
fied  window.  This  is  used  by  XGetNormalHints  and  XGetZoomHints,  and  can  be  used  to 
retrieve  the  value  of  any  property  of  type  xa  wm  size  hints;  thus,  it  is  useful  if  other  proper¬ 
ties  of  that  type  get  defined.  This  function  is  used  almost  exclusively  by  window  managers. 

XGetSizeHints  returns  a  nonzero  Status  if  a  size  hint  was  defined,  and  zero  otherwise. 
For  more  information  on  using  hints,  see  Volume  One,  Chapter  10  >  Inter  client  Communication. 

Structures 

typedef  struct  { 

long  flags;  /*  which  fields  in  structure  are  defined  */ 
int  x,  y; 

int  width,  height; 
int  min_width,  min_height; 
int  max_width,  max_height; 
int  width_inc,  height_inc; 
struct  { 

int  x;  /*  numerator  */ 

int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 

}  XSizeHints; 

/*  flags  argument  in  size  hints  */ 

#define  USPosition  (1L  «  0)  /*  user  specified  x,  y  */ 

♦define  USSize  (1L  «  1)  /*  user  specified  width,  height  */ 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  ID  of  the  window  for  which  size  hints  will  be  returned. 

Returns  the  size  hints  structure. 

Specifies  a  property  atom  of  type  xa_wm_size_hints.  May  be 
x a_wm_normal_h I N T s ,  xa_wm_zoom_hints  (in  Release  3),  or  a  property 
defined  by  an  application. 
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(continued) 


XGetSizeHints 


#def ine 
#def ine 
#def ine 
#define 
#def ine 
#def ine 
#def ine 


PPosition 

PSize 

PMinSize 

PMaxSize 

PResizelnc 

PAspect 

PAllHints 


(1L  «  2)  /*  program  specified  position  */ 

(1L  «  3)  /*  program  specified  size  */ 

(1L  «  4)  /*  program  specified  minimum  size  */ 

(1L  «  5)  /*  program  specified  maximum  size  */ 

(1L  «  6)  /*  program  specified  resize  increments  */ 

(1L  «  7)  /*  program  specified  min/max  aspect  ratios 

(PPosition | PSize I PMinSize I PMaxSize I PResizelnc | PAspect) 


*/ 


Errors 

BadAtom 

BadWindow 


Related  Commands 

XFetchName,  XGetClassHint, XGetlconName, XGetlconSizes, XGetNormal- 
Hints,  XGetTransientForHint,  XGetWMHints,  XGetZoomHints,  XSetClass- 
Hint,  XSetCommand,  XSetlconName,  XSetlconSizes,  XSetNormalHints,  XSet- 
SizeHints,  XSetTransientForHint, XSetWMHints,  XSetZoomHints,  XStore- 
Name. 
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Xlib  -  Colormaps— 


XGetStandardColormap 


\ 


Name 

XGetStandardColormap  —  get  the  standard  colormap  property. 

Synopsis 

Status  XGetStandardColormap  ( display,  w ,  cmap_info,  property) 
Display  *  display  ; 

Window  w; 

XStandardColormap  *  cmap_info ;  /  *  RETURN  */ 

Atom  property ; 

Arguments 

displ  ay 

w 

cmap_info 
property 


Description 

XGetStandardColormap  is  superseded  by  XGetWMColormap  in  Release  4. 

XGetStandardColormap  gets  a  property  on  the  root  window  that  describes  a  standard 
colormap. 

This  call  does  not  install  the  colormap  into  the  hardware  colormap,  it  does  not  allocate  entries, 
and  it  does  not  even  create  a  virtual  colormap.  It  just  provides  information  about  one  design  of 
colormap  and  the  ID  of  the  colormap  if  some  other  client  has  already  created  it  The  applica¬ 
tion  can  otherwise  attempt  to  create  a  virtual  colormap  of  the  appropriate  type,  and  allocate  its 
entries  according  to  the  information  in  the  XStandardColormap  structure.  Installing  the 
colormap  must  then  be  done  with  xinstallColormap,  in  cooperation  with  the  window 
manager.  Any  of  these  steps  could  fail,  and  the  application  should  be  prepared. 

If  the  server  or  another  client  has  already  created  a  standard  colormap  of  this  type,  then  its  ID 
will  be  returned  in  the  colormap  member  of  the  XStandardColormap  structure.  Some 
servers  and  window  managers,  particular  on  high-performance  workstations,  will  create  some 
or  all  of  the  standard  colormaps  so  they  can  be  quickly  installed  when  needed  by  applications. 

An  application  should  go  through  the  standard  colormap  creation  process  only  if  it  needs  the 
special  qualities  of  the  standard  colormaps.  For  one,  they  allow  the  application  to  convert  RGB 
values  into  pixel  values  quickly  because  the  mapping  is  predictable.  Given  an  XStandard¬ 
Colormap  structure  for  an  xa_rgb_best_map  colormap,  and  floating  point  RGB  coefficients 
in  the  range  0.0  to  1.0,  you  can  compose  pixel  values  with  the  following  C  expression: 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Specifies  the  ID  of  the  window  on  which  the  property  is  set.  This  is  normally 
the  root  window. 

Returns  the  filled  colormap  information  structure. 

Specifies  the  atom  indicating  the  type  of  standard  colormap  desired.  The 
predefined  standard  colormap  atoms  are  xa_rgb_best_map, 
XA_RGB_RED_MAP,  XA_RGB_GREEN_MAP,  XA_RGB_BLUE_MAP , 

XA_RGB_DEFAULT_MAP,  and  XA_RGB_GRAY_MAP . 
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(continued) 


XGetStandardColormap 


pixel  =  base_pixel 

+  ((unsigned  long)  (0.5  +  r  *  red_max) )  *  red_mult 

+  ((unsigned  long)  (0.5  +  g  *  green__max)  )  *  green_mult 

+  ((unsigned  long)  (0.5  +  b  *  blue_max) )  *  blue_mult; 

The  use  of  addition  rather  than  logical-OR  for  composing  pixel  values  permits  allocations 

where  the  RGB  value  is  not  aligned  to  bit  boundaries. 

XGetStandardColormap  returns  zero  if  it  fails,  or  nonzero  if  it  succeeds. 

See  Volume  One,  Chapter  7,  Color ,  for  a  complete  description  of  standard  colormaps. 

Structures 

typedef  struct  { 

Colormap  colormap;  /*  ID  of  colormap  created  by  XCreateColormap  */ 

unsigned  long  red_max; 

unsigned  long  red_mult; 

unsigned  long  green_max; 

unsigned  long  green_mult; 

unsigned  long  blue_max; 

unsigned  long  blue_mult; 

unsigned  long  base_pixel; 

/*  new  fields  here  in  R4  */ 

}  XStandardColormap; 

Errors 

BadAtom 

BadWindow 

Related  Commands 

Def aultColormap, DisplayCells, XCopyColormapAndFree, XCreate¬ 
Colormap,  XFreeColormap, XInstallColormap,  XList InstalledColormaps, 
XSetStandardColormap,  XSetWindowColormap,  XUninstallColormap. 
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Xlib  -  Images— 


\ 


Name 

XGetSublmage  —  copy  a  rectangle  in  drawable  to  a  location  within  the  pre-existing  image. 

Synopsis 

Xlmage  *XGetSubImage  ( display,  drawable,  x,  y,  width,  height, 
plane_mask,  format,  dest_image,  dest_x,  dest_y) 
Display  *  display ; 

Drawable  drawable ; 
int  x,  y; 

unsigned  int  width,  height; 
unsigned  long  plane_mask ; 
int  format; 

Xlmage  *dest_i/nage; 
int  dest_x,  dest_y; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 


drawable 

x 

y 

width 

height 


Specifies  the  drawable  from  which  the  rectangle  is  to  be  copied. 

Specify  the  x  and  y  coordinates  of  the  upper-left  comer  of  the  rectangle,  rela¬ 
tive  to  the  origin  of  the  drawable. 

Specify  the  width  and  height  in  pixels  of  the  subimage  taken. 


plane_mask  Specifies  which  planes  of  the  drawable  are  transferred  to  the  image. 
format  Specifies  the  format  for  the  image.  Either  XYPixmap  or  ZPixmap. 


dest_image  Specifies  the  the  destination  image. 

dest_x  Specify  the  x  and  y  coordinates  of  the  destination  rectangle’s  upper  left  cor- 

dest_y  ner,  relative  to  the  image’s  origin. 

Description 

XGetSublmage  updates  the  dest_image  with  the  specified  subimage  in  the  same  manner 
as  XGet  Image,  except  that  it  does  not  create  the  image  or  necessarily  fill  the  entire  image.  If 
format  is  XYPixmap,  the  function  transmits  only  the  bit  planes  you  specify  in 
plane_mask.  If  format  is  ZPixmap,  the  function  transmits  as  zero  the  bits  in  all  planes 
not  specified  in  planejmask.  The  function  performs  no  range  checking  on  the  values  in 
plane_mask  and  ignores  extraneous  bits. 


The  depth  of  the  destination  Xlmage  structure  must  be  the  same  as  that  of  the  drawable. 
Otherwise,  a  BadMatch  error  is  generated.  If  the  specified  subimage  does  not  fit  at  the  speci¬ 
fied  location  on  the  destination  image,  the  right  and  bottom  edges  are  clipped.  If  the  drawable 
is  a  window,  the  window  must  be  mapped  or  held  in  backing  store,  and  it  must  be  the  case  that, 
if  there  were  no  inferiors  or  overlapping  windows,  the  specified  rectangle  of  the  window  would 
be  fully  visible  on  the  screen.  Otherwise,  a  BadMatch  error  is  generated. 
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If  the  window  has  a  backing  store,  the  backing  store  contents  are  returned  for  regions  of  the 
window  that  are  obscured  by  noninferior  windows.  Otherwise,  the  return  contents  of  such 
obscured  regions  are  undefined.  Also  undefined  are  the  returned  contents  of  visible  regions  of 
inferiors  of  different  depth  than  the  specified  window. 

XSub Image  extracts  a  subimage  from  an  image,  instead  of  from  a  drawable  like  XGetSub¬ 
lmage. 

For  more  information  on  images,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadDrawable 

BadMatch  Depth  of  dest_image  is  not  the  same  as  depth  of  drawable. 

BadValue 

Related  Commands 

ImageByteOrder,  XAddPixel,  XCreate Image,  XDestroy Image,  XGet  Image, 
XGetPixel,  XPutlmage,  XPutPixel,  XSublmage. 
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Xlib  -  Window  Manager  Hints — 


\ 


Name 

XGetTextProperty  —  read  one  of  a  window’s  text  properties. 

Synopsis 

Status  XGetTextProperty  (  displ ay,  w,  text _prop,  property) 
Display  ^display ; 

Window  w; 

XTextProperty  *text _jprop;  /*  RETURN  */ 

Atom  property ; 

Arguments 

di spl ay 
w 

text _jprop 
property 

Availability 

Release  4  and  later. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  window. 

Returns  the  XTextProperty  structure. 

Specifies  the  property  name. 


Description 

XGetTextProperty  reads  the  specified  property  from  the  window  and  stores  the  data  in  the 
returned  XTextProperty  structure.  It  stores  the  data  in  the  value  field,  the  type  of  the  data 
in  the  encoding  field,  the  format  of  the  data  in  the  format  field,  and  the  number  of  items  of 
data  in  the  ni terns  field.  The  particular  interpretation  of  the  property’s  encoding  and  data  as 
“text”  is  left  to  the  calling  application.  If  the  specified  property  does  not  exist  on  the  window, 
XGetTextProperty  sets  the  value  field  to  null,  the  encoding  field  to  None,  the  format 
field  to  zero,  and  the  nitems  field  to  zero. 

If  it  was  able  to  set  these  files  in  the  XTextProperty  structure,  XGetTextProperty 
returns  a  non-zero  status;  otherwise,  it  returns  a  zero  status. 

For  more  information,  see  Volume  One,  Chapter  10 ,  Interclient  Communication. 


Structures 

typedef  struct  { 

unsigned  char  *value; 
Atom  encoding; 
int  format; 
unsigned  long  nitems; 
}  XTextProperty; 


/*  same  as  Property  routines  */ 

/*  prop  type  */ 

/*  prop  data  format:  8,  16,  or  32  */ 
/*  number  of  data  items  in  value  */ 


Errors 

BadAtom 

BadWindow 
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Related  Commands 

XFreeStringList, XSetTextProperty, XStringListToTextProperty, XText- 
PropertytoStringList. 


Xlib  Reference  Manual 


251 


XGetTransientForHint 
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\ 


Name 

XGetTransientForHint  —  get  the  xa_wm_transient_for  property  of  a  window. 

Synopsis 

Status  XGetTransientForHint  ( display,  w,  prop_window) 

Display  ^display ; 

Window  w; 

Window  *prop_window ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  ID  of  the  window  to  be  queried. 

prop_window  Returns  the  window  contained  in  the  XA  WM  TRANSIENT  FOR  property  of  the 
specified  window. 


Description 

XGetTransientForHint  obtains  the  xa_wm_transient_for  property  for  the  specified 
window.  This  function  is  normally  used  by  a  window  manager.  This  property  should  be  set  for 
windows  that  are  to  appear  only  temporarily  on  the  screen,  such  as  pop-up  dialog  boxes.  The 
window  returned  is  the  main  window  to  which  this  popup  window  is  related.  This  lets  the  win¬ 
dow  manager  decorate  the  popup  window  appropriately. 

XGetTransientForHint  returns  a  Status  of  zero  on  failure,  and  nonzero  on  success. 

For  more  information  on  using  hints,  see  Volume  One,  Chapter  10 ,  Interclient  Communication. 

Errors 

BadWindow 

Related  Commands 

XFetchName,  XGetClassHint, XGet IconName, XGetlconSizes, XGetNormal- 
Hints,  XGetSizeHints, XGetWMHints,  XGetZoomHints, XSetClassHint, XSet- 
Command,  XSetlconName, XSetlconSizes,  XSetNormalHints,  XSetSizeHints, 
XSetTransientForHint, XSetWMHints, XSetZoomHints, XStoreName. 
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/ 


Name 

XGetVisuallnfo  —  find  the  visual  information  structures  that  match  the  specified  template. 

Synopsis 

XVisuallnfo  *XGetVisualInf o ( display,  vinfo_maskr 
vinfo_template,  nitems) 

Display  ^display ; 
long  vinfo_mask ; 

XVisuallnfo  *vinfo_template; 

int  *  nitems;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

vinfo_mask  Specifies  the  visual  mask  value.  Indicates  which  elements  in  template  are  to 
be  matched. 

vinfo_template 

Specifies  the  visual  attributes  that  are  to  be  used  in  matching  the  visual  struc¬ 
tures. 

nitems  Returns  the  number  of  matching  visual  structures. 

Description 

XGetVisuallnfo  returns  a  list  of  visual  structures  that  describe  visuals  supported  by  the 
server  and  that  match  the  attributes  specified  by  the  vinfo_template  argument.  If  no 
visual  structures  match  the  template,  XGetVisuallnfo  returns  a  null.  To  free  the  data 
returned  by  this  function,  use  XFree. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Structures 

typedef  struct  { 

Visual  *visual; 

VisuallD  visualid; 
int  screen; 
unsigned  int  depth; 
int  class; 

unsigned  long  red_mask; 
unsigned  long  greenjmask; 
unsigned  long  blue_mask; 
int  colormap_size; 
int  bits_per_rgb; 

}  XVisuallnfo; 

/*  The  symbols  for  the  vinfo_mask  argument  are:  */ 

tdefine  VisualNoMask  0x0 

#define  VisuallDMask  0x1 

#define  VisualScreenMask  0x2 
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#define  VisualDepthMask 
#define  VisualClassMask 
#define  VisualRedMaskMask 
#define  VisualGreenMaskMask 
#define  VisualBlueMaskMask 
tdefine  VisualColormapSizeMask 
#define  VisualBitsPerRGBMask 
#define  VisualAllMask 

0x4 

0x8 

0x10 

0x20 

0x40 

0x80 

0x100 

OxlFF 

Related  Commands 

Def aultvisual,  XVisuallDFromVisual, XMatchVisuallnf o,  XListDepths. 
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XGetWMIconName 


/ 


Name 

XGetWMIconName  —  read  a  window’s  xa  wm  icon  name  property. 

Synopsis 

Status  XGetWMIconName  ( display ,  w,  text__prop) 
Display  * display ; 

Window  w ; 

XTextProperty  *text^prop ; /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window. 

text _prop  Returns  the  XTextProperty  structure. 

Availability 

Release  4  and  later. 

Description 

XGetWMIconName  performs  an  XGetTextProperty  on  the  xa_wm_ICON_name  property 
of  the  specified  window.  XGetWMIconName  supersedes  XGetlconName. 

This  function  is  primarily  used  by  window  managers  to  get  the  name  to  be  written  in  a  win¬ 
dow’s  icon  when  they  need  to  display  that  icon. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Structures 

typedef  struct  { 

unsigned  char  *value; 

Atom  encoding; 
int  format; 
unsigned  long  nitems; 

}  XTextProperty; 

Related  Commands 

XGetWMName,  XSetWMIconName,  XSetWMName,  XSetWMProperties. 


/*  same  as  Property  routines  */ 

/*  prop  type  */ 

/*  prop  data  format:  8,  16,  or  32  */ 
/*  number  of  data  items  in  value  */ 
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Name 

XGetWMName  —  read  a  window’s  xa  wm  name  property. 

Synopsis 

Status  XGetWMName  ( display ,  w,  text_prop) 
Display  *  display ; 

Window  w; 

XTextProperty  *text _prop ;/*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  window. 

text _prop  Returns  the  XTextProperty  structure. 

Availability 

Release  4  and  later. 

Description 

XGetWMName  performs  an  XGetTextProperty  on  the  xa_wm_name  property  of  the  speci¬ 
fied  window.  XGetWMName  supersedes  XFetchName. 

XGetWMName  returns  nonzero  if  it  succeeds,  and  zero  if  the  property  has  not  been  set  for  the 
argument  window. 

For  more  information,  see  Volume  One,  Chapter  \0,  Inter  client  Communication. 

Structures 

typedef  struct  { 

unsigned  char  *value; 

Atom  encoding; 
int  format; 
unsigned  long  nitems; 

}  XTextProperty; 

Related  Commands 

XGetWMIconName,  XSetWMIconName,  XSetWMName,  XSetWMProperties. 


/*  same  as  Property  routines  */ 

/*  prop  type  */ 

/*  prop  data  format:  8,  16,  or  32  */ 
/*  number  of  data  items  in  value  */ 
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/ 


Name 

XGetWMNormalHints  —  read  a  window’s  xa_wm_normal_hints  property. 

Synopsis 

Status  XGetWMNormalHints (display ,  w,  hints ,  supplied) 
Display  ^display ; 

Window  w; 

XSizeHints  *hints;/*  RETURN  */ 
long  * supplied; 


Arguments 

di  spl  ay 

w 

hints 

supplied 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
Specifies  the  window. 

Returns  the  size  hints  for  the  window  in  its  normal  state. 

Returns  the  hints  that  were  supplied  by  the  user. 


Availability 

Release  4  and  later. 


Description 

XGetWMNormalHints  returns  the  size  hints  stored  in  the  xa_wm_normal_hints  property  on 
the  specified  window.  If  the  property  is  of  type  xa  wm  size  hints,  of  format  32,  and  is  long 
enough  to  contain  either  an  old  (pre-ICCCM)  or  new  size  hints  structure,  XGetWMNormal¬ 
Hints  sets  the  various  fields  of  the  XSizeHints  structure,  sets  the  supplied  argument  to 
the  list  of  fields  that  were  supplied  by  the  user  (whether  or  not  they  contained  defined  values) 
and  returns  a  non-zero  status.  XGetWMNormalHints  returns  a  zero  status  if  the  application 
specified  no  normal  size  hints  for  this  window. 

XGetWMNormalHints  supersedes  XGetNormalHints. 

If  XGetWMNormalHints  returns  successfully  and  a  pre-ICCCM  size  hints  property  is  read, 
the  supplied  argument  will  contain  the  following  bits: 

(USPosition I USSize | PPosition I PSize I PMinSize I  PMaxSize I PResizelnc | PAspect) 

If  the  property  is  large  enough  to  contain  the  base  size  and  window  gravity  fields  as  well,  the 
supplied  argument  will  also  contain  the  following  bits: 

(PBaseSize | PWinGravity) 

This  function  is  normally  used  only  by  a  window  manager. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Structures 

typedef  struct  { 

long  flags;  /*  marks  which  fields  in  this  structure  are  defined  */ 
int  x,  y;  /*  obsolete  for  new  window  mgrs,  but  clients  */ 
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int  width,  height;  /*  should  set  so  old  wm's  don't  mess  up  * 

int  min_width,  min_height; 

int  max_width,  max_height; 

int  width_inc,  height_inc; 

struct  { 

int  x;  /*  numerator  */ 
int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 

int  base_width,  base_height;  /*  added  by  ICCCM  version  1 

int  win_gravity;  /*  added  by  ICCCM 

version  1  */ 

}  XSizeHints; 

Errors 

BadWindow 

Related  Commands 

XAllocSizeHints,  XGetWMSizeHints,  XSetWMNormalHints, 
WMProperties, XSetWMSizeHints. 


*/ 


XSet- 
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XGetWMSizeHints 


/ 


Name 

XGetWMSizeHints  —  read  a  window’s  xa_wm_size_hints  property. 

Synopsis 

Status  XGetWMSizeHints ( display ,  w,  hints ,  supplied,  property ) 
Display  ^display ; 

Window  w ; 

XSizeHints  *hints ;  /*  RETURN  */ 

long  *supplied ;  / * RE TURN  */ 

Atom  property ; 


Arguments 

di  spl  ay 

w 

hints 
supplied 
property 

Availability 

Release  4  and  later. 

Description 

XGetWMSizeHints  returns  the  size  hints  stored  in  the  specified  property  on  the  named  win¬ 
dow.  If  the  property  is  of  type  xa  wm  size  hints,  of  format  32,  and  is  long  enough  to  con¬ 
tain  either  an  old  (pre-ICCCM)  or  new  size  hints  structure,  XGetWMSizeHints  sets  the  vari¬ 
ous  fields  of  the  XSizeHints  structure,  sets  the  supplied  argument  to  the  list  of  fields  that 
were  supplied  by  the  user  (whether  or  not  they  contained  defined  values),  and  returns  a  non¬ 
zero  status.  If  the  hint  was  not  set,  it  returns  a  zero  status.  To  get  a  window’s  normal  size  hints, 
you  can  use  the  XGetWMNormalHints  function  instead. 

XGetWMSizeHints  supersedes  XGetSizeHints. 

If  XGetWMSizeHints  returns  successfully  and  a  pre-ICCCM  size  hints  property  is  read,  the 
supplied  argument  will  contain  the  following  bits: 

(USPosition | USSize | PPosition | PSize | PMinSize |  PMaxSize | PResizelnc | PAspect) 

If  the  property  is  large  enough  to  contain  the  base  size  and  window  gravity  fields  as  well,  the 
supplied  argument  will  also  contain  the  following  bits: 

(PBaseSize I PWinGravity) 

This  function  is  used  almost  exclusively  by  window  managers. 

For  more  information,  see  Volume  One,  Chapter  \0,  Inter  client  Communication. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Specifies  the  window. 

Returns  the  XSizeHints  structure. 

Returns  the  hints  that  were  supplied  by  the  user. 

Specifies  the  property  name. 
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Structures 


typedef  struct  { 

long  flags;  /*  marks  which  fields  in  this  structure  are  defined 

int  x,  y;  /*  obsolete  for  new  window  mgrs,  but  clients  */ 

int  width,  height;  /*  should  set  so  old  wm's  don't  mess  up  */ 

int  min_width,  min_height; 

int  max_width,  max_height; 

int  width_inc,  height_inc; 

struct  { 


int  x;  /*  numerator  */ 
int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 

int  base_width,  base_height;  /*  added  by  ICCCM  version  1 

int  win_gravity;  /*  added  by  ICCCM  version  1 

}  XSizeHints; 


*/ 


*/ 

*/ 


Errors 

BadAtom 

BadWindow 

Related  Commands 

XAllocSizeHints,  XGetWMNormalHints,  XSetWMNormalHints,  XSetWMSize- 
Hints. 
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XGetWindow  Attributes 


/ 


Name 

XGetWindow  Attributes  —  obtain  the  current  attributes  of  window. 


Synopsis 

Status  XGetWindowAttributes ( display,  w,  window_attributes) 
Display  ^display ; 

Window  w; 

XWindowAttributes  *window_attributes;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  window  whose  current  attributes  you  want. 

window_at tributes 

Returns  a  filled  XWindowAttributes  structure,  containing  the  current  attri¬ 
butes  for  the  specified  window. 

Description 

XGetWindowAttributes  returns  the  XWindowAttributes  structure  containing  the  cur¬ 
rent  window  attributes. 


While  w  is  defined  as  type  Window,  a  Pixmap  can  also  be  used,  in  which  case  all  the  returned 
members  will  be  zero  except  width,  height,  depth,  and  screen. 


XGetWindowAttributes  returns  a  Status  of  zero  on  failure,  or  nonzero  on  success. 
However,  it  will  only  return  zero  if  you  have  defined  an  error  handler  that  does  not  exit,  using 
XSetErrorHandler.  The  default  error  handler  exits,  and  therefore  XGetWindow¬ 
Attributes  never  gets  a  chance  to  return.  (This  is  relevant  only  if  you  are  writing  a  window 
manager  or  other  application  that  deals  with  windows  that  might  have  been  destroyed.) 

The  following  list  briefly  describes  each  member  of  the  XWindowAttributes  structure.  For 
more  information,  see  Volume  One,  Chapter  4,  Window  Attributes. 


x,  y 

width,  height 
border_width 
depth 
visual 


The  current  position  of  the  upper-left  pixel  of  the  window’s  border,  relative 
to  the  origin  of  its  parent. 

The  current  dimensions  in  pixels  of  this  window. 

The  current  border  width  of  the  window. 

The  number  of  bits  per  pixel  in  this  window. 

The  visual  structure. 


root 


The  root  window  ID  of  the  screen  containing  the  window. 


class  The  window  class.  One  of  these  constants:  inputOutput  or  Input- 

Only. 

bit_gravity  The  new  position  for  existing  contents  after  resize.  One  of  the  constants 
ForgetGravity,  StaticGravity,  or  CenterGravity,  or  one  of 
the  compass  constants  (NorthWestGravity,  NorthGravity,  etc.). 
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win_gravity  The  new  position  for  this  window  after  its  parent  is  resized.  One  of  the 
constants  CenterGravity,  UnmapGravity,  StaticGravity,  or 
one  of  the  compass  constants. 

backing_store  When  to  maintain  contents  of  the  window.  One  of  these  constants:  Not- 
Usef  ul,  WhenMapped,  or  Always. 

backing_j?lanes 

The  bit  planes  to  be  preserved  in  a  backing  store. 
backing_j>ixel  The  pixel  value  used  when  restoring  planes  from  a  partial  backing  store. 

save_under  A  boolean  value,  indicating  whether  saving  bits  under  this  window  would 
be  useful. 

colormap  The  colormap  ID  being  used  in  this  window,  or  None. 

map_installed  A  boolean  value,  indicating  whether  the  colormap  is  currently  installed.  If 
True,  the  window  is  being  displayed  in  its  chosen  colors. 

map_state  The  window’s  map  state.  One  of  these  constants:  IsUnmapped,  Is- 
Unviewable,  or  IsViewable.  IsUnviewable  indicates  that  the 
specified  window  is  mapped  but  some  ancestor  is  unmapped. 

all_event_masks 

The  set  of  events  any  client  have  selected.  This  member  is  the  bitwise 
inclusive  OR  of  all  event  masks  selected  on  the  window  by  all  clients. 

your_event_mask 

The  bitwise  inclusive  OR  of  all  event  mask  symbols  selected  by  the  query¬ 
ing  client. 

do_not_propagate_mask 

The  bitwise  inclusive  OR  of  the  event  mask  symbols  that  specify  the  set  of 
events  that  should  not  propagate.  This  is  global  across  all  clients. 

override_redirect 

A  boolean  value,  indicating  whether  this  window  will  override  structure 
control  facilities.  This  is  usually  only  used  for  temporary  pop-up  windows 
such  as  menus.  Either  True  or  False. 

screen  A  pointer  to  the  Screen  structure  for  the  screen  containing  this  window. 

Errors 

BadWindow 


Structures 

The  xwindowAt tributes  structure  contains: 


typedef  struct  { 


int 

x,  y; 

/* 

int 

width. 

height; 

/* 

int 

border 

_width; 

/* 

int 

depth; 

/* 

location  of  window  */ 
width  and  height  of  window 
border  width  of  window  */ 
depth  of  window  */ 


*/ 
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Visual  *visual;  /* 

Window  root;  /* 

int  class;  /★ 

int  bit_gravity;  /★ 

int  win_gravity;  /* 

int  backing_store;  /* 

unsigned  long  backing_planes; /* 
unsigned  long  backing_pixel ;  /* 
Bool  save_under;  /* 

Colormap  colormap;  /* 

Bool  map_installed;  /* 

int  map_state;  /* 

long  all_event_masks;  /* 

long  your_event_mask;  /* 

long  do_not_propagate_mask;  /* 
Bool  override_redirect ;  /* 

Screen  *screen;  /* 

}  XWindowAttributes; 


the  associated  visual  structure  */ 
root  of  screen  containing  window  */ 
InputOutput,  InputOnly*/ 
one  of  bit  gravity  values  */ 
one  of  the  window  gravity  values  */ 
NotUseful,  WhenMapped,  Always  */ 
planes  to  be  preserved  if  possible  */ 
value  to  be  used  when  restoring  planes  */ 
boolean,  should  bits  under  be  saved  */ 
colormap  to  be  associated  with  window  */ 
boolean,  is  colormap  currently  installed*/ 
IsUnmapped,  IsUnviewable,  IsViewable  */ 
set  of  events  all  people  have  interest  in*/ 
my  event  mask  */ 

set  of  events  that  should  not  propagate  */ 
boolean  value  for  override-redirect  */ 
pointer  to  correct  screen  */ 


Related  Commands 

XChangeWindowAt tributes,  XGetGeometry,  XSetWindowBackground,  XSet- 
WindowBackgroundPixmap,  XSetWindowBorder,  XSetWindowBorderPixmap. 
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XGetWindowProperty 


Xlib  -  Properties — 


\ 


Name 

XGetWindowProperty  —  obtain  the  atom  type  and  property  format  for  a  window. 


Synopsis 

int  XGetWindowProperty  ( display,  w,  property ,  long_offset, 

long_length,  delete,  req_type,  actual_type ,  actual_for- 
mat ,  ni terns ,  bytes_after,  prop) 

Display  ^display ; 

Window  w; 

Atom  property ; 

long  long_offset ,  long_length ; 

Bool  delete; 

Atom  req_type ; 

Atom  * actual_type ;  /*  RETURN  */ 

int  *actual_format ;  /*  RETURN  */ 

unsigned  long  *nitems ;  /*  RETURN  */ 

unsigned  long  'kbytes_after ;  /*  RETURN  */ 

unsigned  char  **prop;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

w  Specifies  the  ID  of  the  window  whose  atom  type  and  property  format  you 

want  to  obtain. 


property 

long_offset 

long_length 

delete 


Specifies  the  atom  of  the  desired  property. 

Specifies  the  offset  in  32-bit  quantities  where  data  will  be  retrieved. 

Specifies  the  length  in  32-bit  multiples  of  the  data  to  be  retrieved. 

Specifies  a  boolean  value  of  True  or  False.  If  you  pass  True  and  a  prop¬ 
erty  is  returned,  the  property  is  deleted  from  the  window  after  being  read  and 
a  PropertyNotify  event  is  generated  on  the  window. 


req_type  Specifies  an  atom  describing  the  desired  format  of  the  data.  If  Any- 
PropertyType  is  specified,  returns  the  property  from  the  specified  window 
regardless  of  its  type.  If  a  type  is  specified,  the  function  returns  the  property 
only  if  its  type  equals  the  specified  type. 


actual_type  Returns  the  actual  type  of  the  property. 


actual_format 

Returns  the  actual  data  type  of  the  returned  data. 
ni  terns  Returns  the  actual  number  of  8-,  16-,  or  32-bit  items  returned  in  prop. 

bytes_after  Returns  the  number  of  bytes  remaining  to  be  read  in  the  property  if  a  partial 
read  was  performed. 
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Pr°P  Returns  a  pointer  to  the  data  actually  returned,  in  the  specified  format. 

XGetWindowProperty  always  allocates  one  extra  byte  after  the  data  and 
sets  it  to  null.  This  byte  is  not  counted  in  ni  terns. 

Description 

XGetWindowProperty  gets  the  value  of  a  property  if  it  is  the  desired  type.  XGetWindow¬ 
Property  sets  the  return  arguments  acccording  to  the  following  rules: 

•  If  the  specified  property  does  not  exist  for  the  specified  window,  then:  actual_type  is 
None;  actual_format  =  0;  and  Jby tes_af ter  =  0.  delete  is  ignored  in  this 
case,  and  ni  terns  is  empty. 

•  If  the  specified  property  exists,  but  its  type  does  not  match  req_type ,  then: 
actual_type  is  the  actual  property  type;  actual_format  is  the  actual  property 
format  (never  zero);  and  bytes_after  is  the  property  length  in  bytes  (even  if 
actual_format  is  16  or  32).  delete  is  ignored  in  this  case,  and  nitems  is  empty. 

•  If  the  specified  property  exists,  and  either  req_type  is  AnyPropertyType  or  the 
specified  type  matches  the  actual  property  type,  then:  actual_type  is  the  actual  prop- 
erty  type;  and  actual_format  is  the  actual  property  format  (never  zero). 
bytes_after  and  nitems  are  defined  by  combining  the  following  values: 

N  =  actual  length  of  stored  property  in  bytes  (even  if  actual_forma  t  is  1 6  or  32) 

1  =  4*  1 ong_offse t  (convert  offset  from  longs  into  bytes) 

L  =  MINIMUM((N  -  I),  4  *  long_length)  (BadValue  if  L  <  0) 
bytes_after  =  N  -  (I  +  L)  (number  of  trailing  unread  bytes  in  stored  property) 

The  returned  data  (in  prop )  starts  at  byte  index  I  in  the  property  (indexing  from  0).  The 
actual  length  of  the  returned  data  in  bytes  is  L.  L  is  converted  into  the  number  of  8-,  16-, 
or  32-bit  items  returned  by  dividing  by  1, 2,  or  4  respectively  and  this  value  is  returned  in 
nitems.  The  number  of  trailing  unread  bytes  is  returned  in  bytes_after. 

If  delete  ==  True  and  bytes_af ter  ==  0  the  function  deletes  the  property 
from  the  window  and  generates  a  PropertyNotif  y  event  on  the  window. 

When  XGetWindowProperty  executes  successfully,  it  returns  Success.  The  Success 
return  value  and  the  undocumented  value  returned  on  failure  are  the  opposite  of  all  other  rou¬ 
tines  that  return  int  or  Status.  The  value  of  Success  is  undocumented,  but  is  zero  (0)  in 
the  current  sample  implementation  from  MIT.  The  failure  value,  also  undocumented,  is  cur¬ 
rently  one  (1).  Therefore,  comparing  either  value  to  True  or  False,  or  using  the  syntax  “if 
(!  XGetWindowProperty  (  .  .  .  ))”  is  not  allowed. 

To  free  the  resulting  data,  use  XFree. 

For  more  information,  see  Volume  One,  Chapter  \0Jnterclient  Communication. 


Xlib  Reference  Manual 


265 


XGetWindowProperty 
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Xlib  -  Properties 


Errors 

BadAtom 

BadValue  Value  of  1  ong_offset  caused  L  to  be  negative  above. 

BadWindow 

Related  Commands 

XChangeProperty, XGetAtomName,  XGetFontProperty,  XListProperties, 
XRotateWindowProperties, XSetStandardProperties. 
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/ 


Name 

XGetWMHints  —  read  the  window  manager  hints  property. 

Synopsis 

XWMHints  * XGetWMHints (display,  w) 

Display  ^display ; 

Window  w; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
w  Specifies  the  ID  of  the  window  to  be  queried. 

Description 

This  function  is  primarily  for  window  managers.  XGetWMHints  returns  NULL  if  no 
X a_wm_h I N T s  property  was  set  on  window  w,  and  returns  a  pointer  to  an  XWMHints  structure 
if  it  succeeds.  Programs  must  free  the  space  used  for  that  structure  by  calling  XFree. 

For  more  information  on  using  hints,  see  Volume  One,  Chapter  10 , Interclient  Communication. 

Structures 

typedef  struct  { 
long  flags; 

Bool  input; 
int  initial_state; 

Pixmap  icon_pixmap; 

Window  icon_window; 
int  icon_x,  icon_y; 

Pixmap  icon_mask; 

XID  window_group; 

/*  this  structure  may  be  extended  in  the  future  */ 

}  XWMHints; 

/*  initial  state  flag 
#define  DontCareState 
tdefine  NormalState 
tdefine  ZoomState 
#define  IconicState 
tdefine  InactiveState 

Errors 

BadWindow 

Related  Commands 

XAllocWMHints, XFetchName, XGetClassHint,  XGetlconName, XGetlcon- 
Sizes,  XGetNormalHints,  XGetSizeHints,  XGetTransientForHint,  XGet- 
ZoomHints,  XSetClassHint,  XSetCoiranand,  XSet IconName,  XSetlconSizes, 
XSetNormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, 
XSetZoomHints, XStoreName, XSetWMProperties. 


/*  marks  which  fields  in  this  structure  are  defined  */ 
/*  does  application  need  window  manager  for  input  */ 

/*  see  below  */ 

/*  pixmap  to  be  used  as  icon  */ 

/*  window  to  be  used  as  icon  */ 

/*  initial  position  of  icon  */ 

/*  icon  mask  bitmap  */ 

/*  ID  of  related  window  group  */ 
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Name 

XGetZoomHints  —  read  the  size  hints  property  of  a  zoomed  window. 

Synopsis 

Status  XGetZoomHints  ( display,  w,  zhints) 

Display  * display ; 

Window  w; 

XSizeHints  *zhints ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 
w  Specifies  the  ID  of  the  window  to  be  queried. 

zhints  Returns  a  pointer  to  the  zoom  hints. 

Description 

XGetZoomHints  is  obsolete  beginning  in  Release  4,  because  zoom  hints  are  no  longer 
defined  in  the  ICCCM. 

XGetZoomHints  is  primarily  for  window  managers.  XGetZoomHints  returns  the  size 
hints  for  a  window  in  its  zoomed  state  (not  normal  or  iconified)  read  from  the 
X a_wm_z OOM_H I N T s  property.  It  returns  a  nonzero  Status  if  it  succeeds,  and  zero  if  the 
application  did  not  specify  zoom  size  hints  for  this  window. 

For  more  information  on  using  hints,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Structures 

typedef  struct  { 

long  flags;  /*  which  fields  in  structure  are  defined  */ 
int  xf  y; 

int  width,  height; 
int  min_width,  min_height; 
int  max_width,  max_height; 
int  width_inc,  height_inc; 
struct  { 

int  x;  /*  numerator  */ 

int  y;  /*  denominator  */ 

}  min_aspect,  max_aspect; 

}  XSizeHints; 


/*  flags  argument 

in  size 

hints 

*/ 

#def ine 

□SPosition 

(1L 

« 

0) 

/* 

user  specified  x,  y  */ 

#def ine 

USSize 

(1L 

« 

1) 

/* 

user  specified  width,  height  */ 

#def ine 

PPosition 

(1L 

« 

2) 

/* 

program  specified  position  */ 

#def ine 

PSize 

(1L 

« 

3) 

/* 

program  specified  size  */ 

#def ine 

PMinSize 

(1L 

« 

4) 

/* 

program  specified  minimum  size  */ 

#define 

PMaxSize 

(1L 

« 

5) 

/* 

program  specified  maximum  size  */ 

#def ine 

PResizelnc 

(1L 

« 

6) 

/* 

program  specified  resize  increments  */ 
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#define  PAspect  (1L  «  7)  /*  program  specified  min/max  aspect  ratios  */ 
#def ine  PAllHints  (PPosition I PSize I PMinSize | PMaxSize I PResizelnc I PAspect) 

Errors 

BadWindow 

Related  Commands 

XFetchName,  XGetClassHint, XGetlconName, XGetlconSizes, XGetNormal- 
Hints,  XGetSizeHints, XGetTransientForHint, XGetWMHints, XSetClass- 
Hint,  XSetCommand, XSetlconName, XSetlconSizes,  XSetNormalHints, XSet- 
SizeHints,  XSetTransientForHint, XSetWMHints, XSetZoomHints, XStore- 
Name. 
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\ 


Name 

XGrabButton  —  grab  a  pointer  button. 


Synopsis 

XGrabButton ( display,  button,  modifiers,  grab_window, 

owner_events ,  event_mask ,  pointer_mode ,  keyboard_mode , 
confine_to ,  cursor) 

Display  * display ; 
unsigned  int  button ; 
unsigned  int  modifiers ; 

Window  grab_window; 

Bool  owner_events ; 

unsigned  int  event_mask ; 

int  pointer_mode ,  keyboard_mode ; 

Window  confine_to ; 

Cursor  cursor; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

button  Specifies  the  mouse  button.  May  be  Buttonl,  Button2,  Button3,  But¬ 

ton^  Button5,  or  AnyButton.  The  constant  AnyButton  is  equivalent 
to  issuing  the  grab  request  for  all  possible  buttons.  The  button  symbols  can¬ 
not  be  ORed. 


modifiers  Specifies  a  set  of  keymasks.  This  is  a  bitwise  OR  of  one  or  more  of  the  fol¬ 
lowing  symbols:  ShiftMask,  LockMask,  ControlMask,  ModlMask, 
Mod2Mask,  Mod3Mask,  Mod4Mask,  Mod5Mask,  or  AnyModifier. 
AnyModif  ier  is  equivalent  to  issuing  the  grab  key  request  for  all  possible 
modifier  combinations  (including  no  modifiers). 

grab_window  Specifies  the  ID  of  the  window  you  want  to  the  grab  to  occur  in. 


owner_events 

Specifies  a  boolean  value  of  either  True  or  False.  See  Description  below. 

event_mask  Specifies  the  event  mask  to  take  effect  during  the  grab.  This  mask  is  the  bit¬ 
wise  OR  of  one  or  more  of  the  event  masks  listed  on  the  reference  page  for 
XSelectlnput. 

point er_mode 

Controls  processing  of  pointer  events  during  the  grab.  Pass  one  of  these  con¬ 
stants:  GrabModeSync  or  GrabModeAsync. 


keyboard_mode 

Controls  processing  of  keyboard  events  during  the  grab.  Pass  one  of  these 
constants:  GrabModeSync  or  GrabModeAsync. 

confine_to  Specifies  the  ID  of  the  window  to  confine  the  pointer.  One  possible  value  is 
the  constant  None,  in  which  case  the  pointer  is  not  confined  to  any  window. 
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cursor  Specifies  the  cursor  to  be  displayed  during  the  grab.  One  possible  value  you 

can  pass  is  the  constant  None,  in  which  case  the  existing  cursor  is  used. 

Description 

XGrabButton  establishes  a  passive  grab,  such  that  an  active  grab  may  take  place  when  the 
specified  key/button  combination  is  pressed  in  the  specified  window.  After  this  call,  if 

1)  the  specified  button  is  pressed  when  the  specified  modifier  keys  are  down  (and  no  other 
buttons  or  modifier  keys  are  down), 

2)  grab_window  contains  the  pointer, 

3)  the  confine_to  window  (if  any)  is  viewable,  and 

4)  these  constraints  are  not  satisfied  for  any  ancestor, 

then  the  pointer  is  actively  grabbed  as  described  in  XGrabPointer,  the  last  pointer  grab  time 
is  set  to  the  time  at  which  the  button  was  pressed,  and  the  ButtonPress  event  is  reported. 

The  interpretation  of  the  remaining  arguments  is  as  for  XGrabPointer.  The  active  grab  is 
terminated  automatically  when  all  buttons  are  released  (independent  of  the  state  of  modifier 
keys). 

A  modifier  of  AnyModif  ier  is  equivalent  to  issuing  the  grab  request  for  all  possible  modifier 
combinations  (including  no  modifiers).  A  button  of  AnyButton  is  equivalent  to  issuing  the 
request  for  all  possible  buttons  (but  at  least  one). 

XGrabButton  overrides  all  previous  passive  grabs  by  the  same  client  on  the  same  key/button 
combination  on  the  same  window,  but  has  no  effect  on  an  active  grab.  The  request  fails  if  some 
other  client  has  already  issued  an  XGrabButton  with  the  same  button/key  combination  on  the 
same  window.  When  using  AnyModif  ier  or  AnyButton,  the  request  fails  completely  (no 
grabs  are  established)  if  there  is  a  conflicting  grab  for  any  combination. 

The  owner_events  argument  specifies  whether  the  grab  window  should  receive  all  events 
(False)  or  whether  the  grabbing  application  should  receive  all  events  normally  (True). 

The  point er_mode  and  keyboard_mode  control  the  processing  of  events  during  the  grab. 
If  either  is  GrabModeSync,  events  for  that  device  are  not  sent  from  the  server  to  Xlib  until 
XAllowEvents  is  called  to  release  the  events.  If  either  is  GrabModeAsync,  events  for  that 
device  are  sent  normally. 

An  automatic  grab  takes  place  between  a  ButtonPress  event  and  the  corresponding 
ButtonRelease  event,  so  this  call  is  not  necessary  in  some  of  the  most  common  situations. 
But  this  call  is  necessary  for  certain  styles  of  menus. 

For  more  information  on  grabbing,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 
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Errors 

BadAccess  When  using  AnyModif  ier  or  AnyButton  and  there  is  a  conflicting  grab 

by  another  client.  No  grabs  are  established. 

Another  client  has  already  issued  an  XGrabButton  request  with  the  same 
key/button  combination  on  the  same  window. 

BadCursor 

BadValue 

BadWindow 

Related  Commands 

XChangeActivePointerGrab,  XGrabKey,  XGrabKeyboard,  XGrabPointer, 
XGrabServer, XUngrabButton, XUngrabKey,  XUngrabKeyboard,  XUngrab- 
Pointer,  XUngrabServer. 
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Name 

XGrabKey  —  grab  a  key. 


Synopsis 

XGrabKey  ( display,  keycode ,  modifiers ,  grab  window , 
owner_events ,  pointer_mode ,  keyboard_mode) 
Display  ^display ; 
int  keycode ; 
unsigned  int  modifiers ; 

Window  grab_window ; 

Bool  owner_events ; 

int  pointer_mode ,  keyboard_mode ; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

keycode  Specifies  the  keycode  to  be  grabbed.  It  may  be  a  modifier  key.  Specifying 

AnyKey  is  equivalent  to  issuing  the  request  for  all  key  codes. 

modifiers  Specifies  a  set  of  keymasks.  This  is  a  bitwise  OR  of  one  or  more  of  the  fol¬ 
lowing  symbols:  ShiftMask,  LockMask,  ControlMask,  ModlMask, 
Mod2Mask,  Mod3Mask,  Mod4Mask,  Mod5Mask,  or  AnyModifier. 
AnyModif  ier  is  equivalent  to  issuing  the  grab  key  request  for  all  possible 
modifier  combinations  (including  no  modifiers).  All  specified  modifiers  do 
not  need  to  have  currently  assigned  keycodes. 

grab_window  Specifies  the  window  in  which  the  specified  key  combination  will  initiate  an 
active  grab. 

owner_events 

Specifies  whether  the  grab  window  should  receive  all  events  (True)  or 
whether  the  grabbing  application  should  receive  all  events  normally 
(False). 

point  er_mode 

Controls  processing  of  pointer  events  during  the  grab.  Pass  one  of  these  con¬ 
stants:  GrabModeSync  or  GrabModeAsync. 

k  eyb  o  a  rd_mode 

Controls  processing  of  keyboard  events  during  the  grab.  Pass  one  of  these 
constants:  GrabModeSync  or  GrabModeAsync. 

Description 

XGrabKey  establishes  a  passive  grab  on  the  specified  keys,  such  that  when  the  specified 
key/modifier  combination  is  pressed,  the  keyboard  may  be  grabbed,  and  all  keyboard  events 
sent  to  this  application.  More  formally,  once  an  XGrabKey  call  has  been  issued  on  a  particular 
key/button  combination: 
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Xlib- Grabbing 


•  IF  the  keyboard  is  not  already  actively  grabbed, 

•  AND  the  specified  key,  which  itself  can  be  a  modifier  key,  is  logically  pressed  when  the 
specified  modifier  keys  are  logically  down, 

•  AND  no  other  keys  or  modifier  keys  are  logically  down, 

•  AND  EITHER  the  grab  window  is  an  ancestor  of  (or  is)  the  focus  window  OR  the  grab 
window  is  a  descendent  of  the  focus  window  and  contains  the  pointer, 

•  AND  a  passive  grab  on  the  same  key  combination  does  not  exist  on  any  ancestor  of  the 
grab  window, 

•  THEN  the  keyboard  is  actively  grabbed,  as  for  XGrabKeyboard,  the  last  keyboard  grab 
time  is  set  to  the  time  at  which  the  key  was  pressed  (as  transmitted  in  the  KeyPress 
event),  and  the  KeyPress  event  is  reported. 

The  active  grab  is  terminated  automatically  when  the  specified  key  is  released  (independent  of 
the  state  of  the  modifier  keys). 

The  pointer_mode  and  keyboard_mode  control  the  processing  of  events  during  the  grab. 
If  either  is  GrabModeSync,  events  for  that  device  are  not  sent  from  the  server  to  Xlib  until 
XAllowE vents  is  called  to  send  the  events.  If  either  is  GrabModeAsync,  events  for  that 
device  are  sent  normally. 

For  more  information  on  grabbing,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Errors 

BadAccess  When  using  AnyModif  ier  or  AnyKey  and  another  client  has  grabbed  any 
overlapping  combinations.  In  this  case,  no  grabs  are  established. 

Another  client  has  issued  XGrabKey  for  the  same  key  combination  in 
grab_window. 

BadValue  keycode  is  not  in  the  range  between  min_keycode  and  max_keycode 
as  returned  by  XDisplayKeycodes. 

BadWindow 

Related  Commands 

XChangeActivePointerGrab,  XGrabButton,  XGrabKeyboard,  XGrabPointer, 
XGrabServer,  XUngrabButton, XUngrabKey,  XUngrabKeyboard, XUngrab- 
Pointer,  XUngrabServer. 
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/ 


Name 

XGrabKeyboard  —  grab  the  keyboard. 

Synopsis 

int  XGrabKeyboard ( display,  grab_window,  owner_events , 
pointer_mode,  keyboard_mode,  time) 

Display  ^display ; 

Window  grab_window ; 

Bool  owner_events ; 

int  pointer_mode,  keyboardjmode ; 

Time  time; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 
grab_window  Specifies  the  ID  of  the  window  that  requires  continuous  keyboard  input. 
owner_events 

Specifies  a  boolean  value  of  either  True  or  False.  See  Description  below. 

point  er_mode 

Controls  processing  of  pointer  events  during  the  grab.  Pass  either  Grab- 
ModeSync  or  GrabModeAsync. 

keyboard_mode 

Controls  processing  of  keyboard  events  during  the  grab.  Pass  either  Grab- 
ModeSync  or  GrabModeAsync. 

time  Specifies  the  time  when  the  grab  should  take  place.  Pass  either  a  timestamp, 

expressed  in  milliseconds,  or  the  constant  Cur  rent  Time. 

Description 

XGrabKeyboard  actively  grabs  control  of  the  main  keyboard.  Further  key  events  are 
reported  only  to  the  grabbing  client.  This  request  generates  Focus  In  and  FocusOut  events. 

XGrabKeyboard  processing  is  controlled  by  the  value  in  the  owner_events  argument: 

•  If  owner_events  is  False,  all  generated  key  events  are  reported  to  grab_window. 

•  If  owner_events  is  True,  then  if  a  generated  key  event  would  normally  be  reported 
to  this  client,  it  is  reported  normally.  Otherwise  the  event  is  reported  to  grab_window. 

Both  KeyPress  and  KeyRelease  events  are  always  reported,  independent  of  any 
event  selection  made  by  the  client. 

XGrabKeyboard  processing  of  pointer  events  and  keyboard  events  are  controlled  by 
point er_mode  and  keyboard_mode : 

•  If  the  pointer_mode  or  keyboard_mode  is  GrabModeAsync,  event  processing 
for  the  respective  device  continues  normally. 

•  For  keyboard_mode  GrabModeAsync  only:  if  the  keyboard  was  currently  frozen 
by  this  client,  then  processing  of  keyboard  events  is  resumed. 
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•  If  the  pointer_mode  or  keyboard_mode  is  GrabModeSync,  events  for  the 
respective  device  are  queued  by  the  server  until  a  releasing  XAllowE vents  request 
occurs  or  until  the  keyboard  grab  is  released  as  described  above. 

If  the  grab  is  successful,  XGrabKeyboard  returns  the  constant  GrabSuccess.  XGrab¬ 
Keyboard  fails  under  the  following  conditions  and  returns  the  following: 

•  If  the  keyboard  is  actively  grabbed  by  some  other  client,  it  returns  AlreadyGrabbed. 

•  If  grab_window  is  not  viewable,  it  returns  GrabNotViewable. 

•  If  time  is  earlier  than  the  last  keyboard  grab  time  or  later  than  the  current  server  time,  it 
returns  GrablnvalidTime. 

•  If  the  pointer  is  frozen  by  an  active  grab  of  another  client,  the  request  fails  with  a  status 
GrabFrozen. 

If  the  grab  succeeds,  the  last  keyboard  grab  time  is  set  to  the  specified  time,  with  Current - 
Time  replaced  by  the  current  X  server  time. 

For  more  information  on  grabbing,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Errors 

BadValue 

BadWindow 

Related  Commands 

XChangeActivePointerGrab,  XGrabButton,  XGrabKey,  XGrabPointer,  XGrab- 
Server, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrabPointer, 
XUngrabServer. 
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XGrabPointer 


/ 


Name 

XGrabPointer  —  grab  the  pointer. 

Synopsis 

int  XGrabPointer  ( display,  grab_window,  owner_e vents, 

event_mask,  pointer_mode ,  keyboard_mode ,  confine_to, 
cursor ,  time) 

Display  * display ; 

Window  grab_window ; 

Bool  owner_events ; 

unsigned  int  event_mask ; 

int  point  e  r_mode ,  keyboard_mode ; 

Window  confine_to ; 

Cursor  cursor; 

Time  time; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

grab_window  Specifies  the  ID  of  the  window  that  should  grab  the  pointer  input  independent 
of  pointer  location. 

owner_events 

Specifies  if  the  pointer  events  are  to  be  reported  normally  within  this  applica¬ 
tion  (pass  True)  or  only  to  the  grab  window  (pass  False). 

eventjmask  Specifies  the  event  mask  symbols  that  can  be  ORed  together.  Only  events 
selected  by  this  mask,  plus  ButtonPress  and  ButtonRelease,  will  be 
delivered  during  the  grab.  See  XSelect  Input  for  a  complete  list  of  event 
masks. 

point  er_mode 

Controls  further  processing  of  pointer  events.  Pass  either  GrabModeSync 
or  GrabModeAsync. 

keyboard_mode 

Controls  further  processing  of  keyboard  events.  Pass  either  GrabModeSync 
or  GrabModeAsync. 

confine_to  Specifies  the  ID  of  the  window  to  confine  the  pointer.  One  option  is  None,  in 
which  case  the  pointer  is  not  confined  to  any  window. 

cursor  Specifies  the  ID  of  the  cursor  that  is  displayed  with  the  pointer  during  the 

grab.  One  option  is  None,  which  causes  the  cursor  to  keep  its  current  pattern. 

time  Specifies  the  time  when  the  grab  request  took  place.  Pass  either  a  timestamp, 

expressed  in  milliseconds  (from  an  event),  or  the  constant  CurrentTime. 


Xlib  Reference  Manual 


277 


XGrabPointer 


(continued) 


Xlib  -  Grabbing 


Description 

XGrabPointer  actively  grabs  control  of  the  pointer.  Further  pointer  events  are  only  reported 
to  the  grabbing  client  until  xungrabPointer  is  called. 

event_mask  is  always  augmented  to  include  ButtonPressMask  and  ButtonRelease- 
Mask.  If  owner_events  is  False,  all  generated  pointer  events  are  reported  to 
grab_window ,  and  are  only  reported  if  selected  by  event_mask.  If  owner_events  is 
True,  then  if  a  generated  pointer  event  would  normally  be  reported  to  this  client,  it  is  reported 
normally;  otherwise  the  event  is  reported  with  respect  to  the  grab_window ,  and  is  only 
reported  if  selected  by  event_mask.  For  either  value  of  owner_events%  unreported  events 
are  discarded. 

poihter_mode  controls  processing  of  pointer  events  during  the  grab,  and  keyboard_mode 
controls  further  processing  of  main  keyboard  events.  If  the  mode  is  GrabModeAsync,  event 
processing  continues  normally.  If  the  mode  is  GrabModeSync,  events  for  the  device  are 
queued  by  the  server  but  not  sent  to  clients  until  the  grabbing  client  issues  a  releasing 
XAllowE vents  request  or  an  xungrabPointer  request. 

If  a  cursor  is  specified,  then  it  is  displayed  regardless  of  which  window  the  pointer  is  in.  If  no 
cursor  is  specified,  then  when  the  pointer  is  in  grab_window  or  one  of  its  subwindows,  the 
normal  cursor  for  that  window  is  displayed.  When  the  pointer  is  outside  grab_window,  the 
cursor  for  grab_window  is  displayed. 

If  a  confine_to  window  is  specified,  then  the  pointer  will  be  restricted  to  that  window.  The 
confine_to  window  need  have  no  relationship  to  the  grab_window.  If  the  pointer  is  not 
initially  in  the  confine_to  window,  then  it  is  warped  automatically  to  the  closest  edge  (and 
enter/leave  events  generated  normally)  just  before  the  grab  activates.  If  the  conf±ne_to 
window  is  subsequently  reconfigured,  the  pointer  will  be  warped  automatically  as  necessary  to 
keep  it  contained  in  the  window. 

The  time  argument  lets  you  avoid  certain  circumstances  that  come  up  if  applications  take  a 
long  while  to  respond  or  if  there  are  long  network  delays.  Consider  a  situation  where  you  have 
two  applications,  both  of  which  normally  grab  the  pointer  when  clicked  on.  If  both  applica¬ 
tions  specify  the  timestamp  from  the  ButtonPress  event,  the  second  application  will  suc¬ 
cessfully  grab  the  pointer,  while  the  first  will  get  a  return  value  of  AlreadyGrabbed,  indicat¬ 
ing  that  the  other  application  grabbed  the  pointer  before  its  request  was  processed.  This  is  the 
desired  response  because  the  latest  user  action  is  most  important  in  this  case. 

XGrabPointer  generates  EnterNotif y  and  LeaveNotify  events. 

If  the  grab  is  successful,  it  returns  the  constant  GrabSuccess.  The  XGrabPointer  func¬ 
tion  fails  under  the  following  conditions,  with  the  following  return  values: 

•  If  grab_window  or  confine_to  window  is  not  viewable,  or  if  the  conf ine_to 
window  is  completely  off  the  screen,  GrabNot viewable  is  returned. 

•  If  the  pointer  is  actively  grabbed  by  some  other  client,  the  constant  AlreadyGrabbed 
is  returned. 

•  If  the  pointer  is  frozen  by  an  active  grab  of  another  client,  GrabFrozen  is  returned. 
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•  If  the  specified  time  is  earlier  than  the  last-pointer-grab  time  or  later  than  the  current  X 
server  time,  GrablnvalidTime  is  returned.  (If  the  call  succeeds,  the  last  pointer  grab 
time  is  set  to  the  specified  time,  with  the  constant  Cur  rent  Time  replaced  by  the  cur¬ 
rent  X  server  time.) 

For  more  information  on  grabbing,  see  Volume  One,  Chapter  9,  The  Keyboard  and  Pointer. 

Errors 

BadCursor 

BadValue 

BadWindow 

Related  Commands 

XChangeActivePointerGrab,  XGrabButton,  XGrabKey,  XGrabKeyboard, 
XGrabServer,  XUngrabButton,  XUngrabKey,  XUngrabKeyboard,  XUngrab- 
Pointer,  XUngrabServer. 
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\ 


Name 

XGrabServer  —  grab  the  server. 

Synopsis 

XGrabServer  ( display ) 

Display  ^display ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

Description 

Grabbing  the  server  means  that  only  requests  by  the  calling  client  will  be  acted  on.  All  others 
will  be  queued  in  the  server  until  the  next  XUngrabServer  call.  The  X  server  should  not  be 
grabbed  any  more  than  is  absolutely  necessary. 

Related  Commands 

XChangeActivePointerGrab,  XGrabButton,  XGrabKey,  XGrabKeyboard, 
XGrabPointer,  XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer,  XUngrabServer. 
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XlconifyWindow 


/ 


Name 

XlconifyWindow  —  request  that  a  top-level  window  be  iconified. 

Synopsis 

Status  XlconifyWindow ( display,  w,  screen_number) 

Display  ^display ; 

Window  w; 

int  screen_number ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

w  Specifies  the  window. 

screen_number 

Specifies  the  appropriate  screen  number  on  the  server. 


Availability 

Release  4  and  later. 

Description 

XlconifyWindow  sends  a  WM_c HAN GE_S TATE  ClientMessage  event  with  a  format  of  32 
and  a  first  data  element  of  iconicState  (as  described  in  Section  4.1.4  of  the  Inter-Client 
Communication  Conventions  Manual  in  Volume  Zero,  X  Protocol  Reference  Manual ),  to  the 
root  window  of  the  specified  screen.  Window  managers  may  elect  to  receive  this  message  and, 
if  the  window  is  in  its  normal  state,  may  treat  it  as  a  request  to  change  the  window’s  state  from 
normal  to  iconic.  If  the  wm  change  state  property  cannot  be  interned,  XlconifyWindow 
does  not  send  a  message  and  returns  a  zero  status.  It  returns  a  nonzero  status  if  the  client  mes¬ 
sage  is  sent  successfully;  otherwise,  it  returns  a  zero  status. 

For  more  information,  see  Volume  One,  Chapter  \0,  Inter  client  Communication. 

Errors 

BadWindow 

Related  Commands 

XReconf igureWindow, XWithdrawWindow. 
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\ 


Name 

XlfEvent  —  wait  for  event  matched  in  predicate  procedure. 

Synopsis 

XlfEvent  ( display,  event ,  predicate,  args) 

Display  ^display ; 

XEvent  *  event;  /*  RETURN  */ 

Bool  (* predicate )  ()  ; 
char  *args ; 

Arguments 

displ ay 
event 
predicate 

args 

Description 

XlfEvent  checks  the  event  queue  for  events,  uses  the  user-supplied  routine  to  check  if  one 
meets  certain  criteria,  and  removes  the  matching  event  from  the  input  queue.  XlfEvent 
returns  only  when  the  specified  predicate  procedure  returns  True  for  an  event.  The  specified 
predicate  is  called  once  for  each  event  on  the  queue  until  a  match  is  made,  and  each  time  an 
event  is  added  to  the  queue,  with  the  arguments  display ,  event ,  and  arg. 

If  no  matching  events  exist  on  the  queue,  XlfEvent  flushes  the  request  buffer  and  waits  for  an 
appropriate  event  to  arrive.  Use  XChecklf  Event  if  you  don’t  want  to  wait  for  an  event. 

For  more  information,  see  Volume  One,  Chapter  8,  Events. 

Related  Commands 

QLength, XAllowEvents, XChecklf Event,  XCheckMaskEvent,  XCheckTyped- 
Event,  XCheckTypedWindowEvent, XCheckWindowEvent,  XEventsQueued, 
XGetlnputFocus,  XGetMotionEvents, XMaskEvent, XNextEvent,  XPeekEvent, 
XPeeklf Event,  XPending,  XPutBackEvent,  XSelectlnput, XSendEvent,  XSet- 
InputFocus, XSynchronize, XWindowEvent. 


Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 
Returns  the  matched  event. 

Specifies  the  procedure  to  be  called  to  determine  if  the  next  event  satisfies 
your  criteria. 

Specifies  the  user-specified  arguments  to  be  passed  to  the  predicate  proce¬ 
dure. 
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/ 


Name 

XlnsertModifiermapEntry  —  add  a  new  entry  to  an  XModif  ierKeymap  structure. 

Synopsis 

XModif  ierKeymap  *XInsertModif  iermapEntry  ( modmap , 
keysym_entry,  modifier) 

XModif ierKeymap  * modmap; 

KeyCode  keysym_en t ry ; 
int  modifier ; 


Arguments 

modmap  Specifies  a  pointer  to  an  XModif  ierKeymap  structure. 

keysym_en  t  ry 

Specifies  the  keycode  of  the  key  to  be  added  to  modmap. 

modifier  Specifies  the  modifier  you  want  mapped  to  the  keycode  specified  in 
keysym_entry.  This  should  be  one  of  the  constants:  ShiftMapIndex, 
LockMapIndex,  ControlMapIndex,  ModlMapIndex,  Mod2Map- 
Index,  Mod3MapIndex,  Mod4MapIndex,  or  Mod5MapIndex. 

Description 

XlnsertModifiermapEntry  returns  an  XModif  ierKeymap  structure  suitable  for  cal¬ 
ling  xSetModif  ierMapping,  in  which  the  specified  keycode  is  deleted  from  the  set  of  key- 
codes  that  is  mapped  to  the  specified  modifier  (like  Shift  or  Control).  Xlnsert¬ 
ModifiermapEntry  does  not  change  the  mapping  itself. 

This  function  is  normally  used  by  calling  XGetModif  ierMapping  to  get  a  pointer  to  the 
current  XModif  ierKeymap  structure  for  use  as  the  modmap  argument  to  Xlnsert- 
Modi fie  rmapEnt  r y . 

Note  that  the  structure  pointed  to  by  modmap  is  freed  by  XlnsertModifiermapEntry.  It 
should  not  be  freed  or  otherwise  used  by  applications. 

For  a  description  of  the  modifier  map,  see  XSetModif  ierMapping. 


Structures 

typedef  struct  { 

int  max  keypermod;  /*  server's  max  number  of  keys  per  modifier  */ 

KeyCode” *modif iermap;  /*  an  8  by  max_keypermod  array  of 

*  keycodes  to  be  used  as  modifiers  */ 

}  XModif ierKeymap; 


#define  ShiftMapIndex  0 
♦define  LockMapIndex  1 
♦define  ControlMapIndex  2 
♦define  ModlMapIndex  3 
♦define  Mod2MapIndex  4 
♦define  Mod3MapIndex  5 
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♦define  Mod4MapIndex 
♦define  Mod5MapIndex 


6 

7 


Related  Commands 

XDeleteModif  iermapEntry,  XFreeModif iermap,  XGetKeyboardMapping, 
XGetModif ierMapping,  XKeycodeToKeysym,  XKeysymToKeycode,  XKeysymTo- 
String,  XLookupKeysym,  XLookupString,  XNewModif  ierMap,  XQueryKeymap, 
XRebindKeySym,  XRef reshKeyboardMapping,  XSetModif ierMapping, 

XSt  r  ingToKey  sym. 
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XlnstallColormap 


/ 


Name 

XlnstallColormap  —  install  a  colormap. 

Synopsis 

XlnstallColormap  ( display,  cmap) 

Display  'display ; 

Colormap  cmap; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

cmap  Specifies  the  colormap  to  install. 

Description 

XlnstallColormap  installs  a  virtual  colormap  into  a  hardware  company.  If  there  is  only 
one  hardware  colormap,  XlnstallColormap  loads  a  virtual  colormap  into  the  hardware 
colormap.  All  windows  associated  with  this  colormap  immediately  display  with  their  chosen 
colors.  Other  windows  associated  with  the  old  colormap  will  display  w'ith  false  colors. 

If  additional  hardware  colormaps  are  possible,  XlnstallColormap  loads  the  new  hardware 
map  and  keeps  the  existing  ones.  Other  windows  will  then  remain  in  their  true  colors  unless  the 
limit  for  colormaps  has  been  reached.  If  the  maximum  number  of  allowed  hardware  colormaps 
is  already  installed,  an  old  colormap  is  swapped  out  The  MinCmapsOf  Screen  ( screen ) 
and  MaxCmapsOf  Screen  ( screen )  macros  can  be  used  to  determine  how'  many  hardware 
colormaps  are  supported. 

If  cmap  is  not  already  an  installed  map,  a  ColormapNotify  event  is  generated  on  every 
window  having  cmap  as  an  attribute.  If  a  colormap  is  uninstalled  as  a  result  of  the  install,  a 
ColormapNotify  event  is  generated  on  every  window  having  that  colormap  as  an  attribute. 

Colormaps  are  usually  installed  and  uninstalled  by  the  window  manager,  not  by  clients. 

At  any  time,  there  is  a  subset  of  the  installed  colormaps,  viewed  as  an  ordered  list,  called  the 
“required  list.”  The  length  of  the  required  list  is  at  most  the  min_maps  specified  for  each 
screen  in  the  Display  structure.  When  a  colormap  is  installed  with  XlnstallColormap  it 
is  added  to  the  head  of  the  required  list  and  the  last  colormap  in  the  list  is  removed  if  necessary 
to  keep  the  length  of  the  list  at  mim_maps.  When  a  colormap  is  uninstalled  with 
XUninstallColormap  and  it  is  in  the  required  list,  it  is  removed  from  the  list.  No  other 
actions  by  the  server  or  the  client  change  the  required  list.  It  is  important  to  realize  that  on  all 
but  high-performance  workstations,  min_maps  is  likely  to  be  1. 

If  the  hardware  colormap  is  immutable,  and  therefore  installing  any  colormap  is  impossible, 
XlnstallColormap  will  work  but  not  do  anything. 

For  more  information,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadColormap 
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Related  Commands 

Def aultColormap, DisplayCells, XCopyColormapAndFree, XCreate- 
Colormap, XFreeColormap,  XGetStandardColormap,  XListlnstalled- 
Colormaps,  XSetStandardColormap,  XSetWindowColormap,  XUninstall- 
Colormap. 
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XlntemAtom 


/ 


Name 

XlntemAtom  —  return  an  atom  for  a  given  property  name  string. 

Synopsis 

Atom  XlntemAtom  (  display,  property_name ,  only_if_exists) 

Display  ^display ; 
char  *property_name ; 

Bool  only_if_exists ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
property_name 

Specifies  the  string  name  of  the  property  for  which  you  want  the  atom.  Upper 
or  lower  case  is  important.  The  string  should  be  in  ISO  LATIN- 1  encoding, 
which  means  that  the  first  128  character  codes  are  ASCII,  and  the  second  128 
character  codes  are  for  special  characters  needed  in  western  languages  other 
than  English. 

only_i  f_exi  st  s 

Specifies  a  boolean  value:  if  no  such  property_name  exists  Xlntern- 
Atom  will  return  None  if  this  argument  is  set  to  True  or  will  create  the  atom 
if  it  is  set  to  False. 

Description 

XlntemAtom  returns  the  atom  identifier  corresponding  to  string  property_name. 

If  the  atom  does  not  exist,  then  XlntemAtom  either  returns  None  (if  only_if_exists  is 
True)  or  creates  the  atom  and  returns  its  ID  (if  only_if_exists  is  False). 

The  string  name  should  be  a  null-terminated.  Case  matters:  the  strings  “thing,”  “Thing,”  and 
“thinG”  all  designate  different  atoms. 

The  atom  will  remain  defined  even  after  the  client  that  defined  it  has  exited.  It  will  become 
undefined  only  when  the  last  connection  to  the  X  server  closes.  Therefore,  the  number  of  atoms 
interned  should  be  kept  to  a  minimum. 

This  function  is  the  opposite  of  XGetAtomName,  which  returns  the  atom  name  when  given  an 
atom  ID. 

Predefined  atoms  require  no  call  to  XlntemAtom.  Predefined  atoms  are  defined  in 
<Xll/Xatom.h>  and  begin  with  the  prefix  “XA_”.  Predefined  atoms  are  the  only  ones  that  do 
not  require  a  call  to  XlntemAtom. 

Errors 

BadAlloc 

BadValue 
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XlnternAtom 


(continued) 


Xlib  -  Properties 


Related  Commands 

XChangeP roperty,  XDeleteProperty,  XGetAtomName,  XGetFontProperty, 
XGetWindowProperty, XListProperties,  XRotateWindowProperties, XSet- 
StandardProperties. 
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—  Xlib  -  Regions 


XlntersectRegion 


/ 


Name 

XlntersectRegion  —  compute  the  intersection  of  two  regions. 

Synopsis 

XlntersectRegion  (  sra ,  srb,  dr) 

Region  sra,  srb; 

Region  dr;  /*  RETURN  */ 


Arguments 

sra  Specify  the  two  regions  with  which  to  perform  the  computation. 

srb 

dr  Returns  the  result  of  the  computation. 


Description 

XlntersectRegion  generates  a  region  that  is  the  intersection  of  two  regions. 

Structures 

Region  is  a  pointer  to  an  opaque  structure  type. 


Related  Commands 

XClipBox,  XCreateRegion, XDestroyRegion, XEmptyRegion,  XEqualRegion, 
XOf f setRegion, XPointlnRegion, XPolygonRegion,  XRectlnRegion,  XSet- 
Region,  XShrinkRegion, XSubtractRegion,  XUnionRectWithRegion, XUnion- 
Region,  XXorRegion. 
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XKeycodeToKeysym 


Xlib -Keyboard  — 


\ 


Name 

XKeycodeToKeysym  —  convert  a  keycode  to  a  keysym. 

Synopsis 

KeySym  XKeycodeToKeysym  ( display,  keycode,  index) 

Display  ^display ; 

KeyCode  keycode ; 
int  index; 

Arguments 

di  spl  ay 

keycode 
index 

Description 

XKeycodeToKeysym  returns  one  of  the  keysyms  defined  for  the  specified  keycode. 
XKeycodeToKeysym  uses  internal  Xlib  tables,  index  specifies  which  keysym  in  the  array 
of  keysyms  corresponding  to  a  keycode  should  be  returned.  If  no  symbol  is  defined, 
XKeycodeToKeysym  returns  NoSymbol. 

Related  Commands 

IsCursorKey, IsFunctionKey,  IsKeypadKey,  IsMiscFunctionKey,  Is- 
Modif  ierKey,  IsPFKey,  XChangeKeyboardMapping,  XDeleteModif  iermap- 
Entry, XDisplayKeycodes, XFreeModif iermap,  XGetKeyboardMapping,  XGet- 
Modif ierMapping,  XInsertModif iermapEntry, XKeysymToKeycode,  XKeysym- 
ToString,  XLookupKeysym,  XLookupString,  XNewModif ierMap, XQuery- 
Keymap,  XRebindKeySym,  XRef reshKeyboardMapping,  XSetModif  ierMapping, 
XStringToKeysym. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDi splay. 
Specifies  the  keycode. 

Specifies  which  keysym  in  the  list  for  the  keycode  to  return. 
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—  Xlib  -  Keyboard 


XKeysymToKeycode 


/ 


Name 

XKeysymToKeycode  —  convert  a  keysym  to  the  appropriate  keycode. 

Synopsis 

KeyCode  XKeysymToKeycode (  display,  keysym) 

Display  ^display ; 

Keysym  keysym ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDisplay. 

keysym  Specifies  the  keysym  that  is  to  be  searched  for. 

Description 

XKeysymToKeycode  returns  the  keycode  corresponding  to  the  specified  keysym  in  the  cur¬ 
rent  mapping.  If  the  specified  keysym  is  not  defined  for  any  keycode,  XKeysymToKeycode 
returns  zero. 

Related  Commands 

IsCursorKey, IsFunctionKey, IsKeypadKey,  IsMiscFunct ionKey,  Is- 
Modif  ierKey,  IsPFKey,  XChangeKeyboardMapping,  XDeleteModif  iermap- 
Entry,  XDisplayKeycodes,  XFreeModif  iermap,  XGetKeyboardMapping,  XGet- 
Modif  ierMapping,  XInsertModif  iermapEntry,  XKeycodeToKeysym,  XKeysym- 
ToString,  XLookupKeysym,  XLookupString,  XNewModif  ierMap,  XQuery- 
Keymap,  XRebindKeySym,  XRef reshKeyboardMapping,  XSetModif  ierMapping, 
XStringToKeysym. 
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XKeysymToString 


Xlib  -  Keyboard  — 


\ 


Name 

XKeysymToString  —  convert  a  keysym  symbol  to  a  string. 

Synopsis 

char  *XKeysymToString ( keysym) 

KeySym  keysym ; 

Arguments 

keysym  Specifies  the  keysym  that  is  to  be  converted. 

Description 

XKeysymToString  converts  a  keysym  symbol  (a  number)  into  a  character  string.  The 
returned  string  is  in  a  static  area  and  must  not  be  modified.  If  the  specified  keysym  is  not 
defined,  XKeysymToString  returns  NULL.  For  example,  XKeysymToString  converts 
XK_Shift  to  “Shift”. 

Note  that  XKeysymString  does  not  return  the  string  that  is  mapped  to  the  keysym,  but  only  a 
string  version  of  the  keysym  itself.  In  other  words,  even  if  the  FI  key  is  mapped  to  the  string 
STOP”  using  XRebindKeysym,  XKeysymToString  still  returns  “FI”.  XLookupString, 
however,  would  return  “STOP”. 

In  Release  4,  XKeysymToString  can  process  keysyms  that  are  not  defined  by  the  Xlib  stan¬ 
dard.  Note  that  the  set  of  keysyms  that  are  available  in  this  manner  and  the  mechanisms  by 
which  Xlib  obtains  them  is  implementation  dependent.  (In  the  MIT  sample  implementation, 
the  resource  file  /usr/lib/Xl  1  /XKeysymDB  is  used  starting  in  Release  4.  The  keysym  name  is 
used  as  the  resource  name,  and  the  resource  value  is  the  keysym  value  in  uppercase  hexade¬ 
cimal.) 

Related  Commands 

IsCursorKey, IsFunctionKey, IsKeypadKey,  IsMiscFunctionKey,  Is- 
Modif  ierKey,  IsPFKey,  XChangeKeyboardMapping,  XDeleteModif iermap- 
Entry,  XFreeModif  iermap,  XGetKeyboardMapping,  XGetModif  ierMapping, 
XInsertModif  iermapEntry,  XKeycodeToKeysym,  XKeysymToKeycode, 
XLookupKeysym,  XLookupString,  XNewModif ierMap,  XQueryKeymap,  XRebind¬ 
Keysym,  XRef reshKeyboardMapping,  XSetModif  ierMapping,  XStringTo- 
Keysym. 
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— Xlib  -  Client  Connections 


XKillClient 


/ 


Name 

XKillClient  —  destroy  a  client  or  its  remaining  resources. 

Synopsis 

XKillClient ( display,  resource) 

Display  ^display ; 

XID  resource ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

resource  Specifies  any  resource  created  by  the  client  you  want  to  destroy,  or  the  con¬ 

stant  AllTemporary. 

Description 

If  a  valid  resource  is  specified,  XKillClient  forces  a  close-down  of  the  client  that  created 
the  resource.  If  the  client  has  already  terminated  in  either  RetainPermanent  or  Retain- 
Temporary  mode,  all  of  the  client’s  resources  are  destroyed.  If  AllTemporary  is  specified 
in  the  resource  argument,  then  the  resources  of  all  clients  that  have  terminated  in  Retain- 
Temporary  are  destroyed. 

For  more  information,  see  Volume  One,  Chapter  13,  Other  Programming  Techniques. 

Errors 

BadValue 

Related  Commands 

XSetCloseDownMode. 
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XListDepths 


Xlib  -  Window  Manager  Hints— 


\ 


Name 

XListDepths  —  determine  the  depths  available  on  a  given  screen. 

Synopsis 

int  *XListDepths  (  display ,  screen_number ,  count) 
Display  *  display ; 
int  screen_number ; 
int  *  count;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
screen_number 

Specifies  the  appropriate  screen  number  on  the  host  server. 
count  Returns  the  number  of  depths. 

Availability 

Release  4  and  later. 

Description 

XListDepths  returns  the  array  of  depths  that  are  available  on  the  specified  screen.  If  the 
specified  screen_number  is  valid  and  sufficient  memory  for  the  array  can  be  allocated, 
XListDepths  sets  count  to  the  number  of  available  depths.  Otherwise,  it  does  not  set 
count  and  returns  null.  To  release  the  memory  allocated  for  the  array  of  depths,  use  XFree. 

Related  Commands 

DefaultDepthOf  Screen  macro,  Def  aultDepth  macro,  XListPixmapFormats. 
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—  Xlib  -  Extensions 


XListExtensions 


/ 


Name 

XListExtensions  —  return  a  list  of  all  extensions  to  X  supported  by  Xlib  and  the  server. 

Synopsis 

char  **XListExtensions ( display,  nextensions) 

Display  *display ; 

int  *nextensions ;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
nextensions  Returns  the  number  of  extensions  in  the  returned  list. 

Description 

XListExtensions  lists  all  the  X  extensions  supported  by  Xlib  and  the  current  server.  The 
returned  strings  will  be  in  ISO  LATIN- 1  encoding,  which  means  that  the  first  128  character 
codes  are  ASCII,  and  the  second  128  character  codes  are  for  special  characters  needed  in  west¬ 
ern  languages  other  than  English. 

For  more  information  on  extensions,  see  Volume  One,  Chapter  13,  Other  Programming  Tech¬ 
niques. 

Related  Commands 

XFreeExtensionList, XQueryExtension. 
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XListFonts 


Xlib -Fonts— 


\ 


Name 

XListFonts  —  return  a  list  of  the  available  font  names. 

Synopsis 

char  **XListFonts ( display,  pattern ,  maxnames,  actual_count) 
Display  *  display ; 
char  * pattern ; 
int  maxnames; 

int  *  actual_count ;  /*  RETURN  */ 


Arguments 

displ ay 
pattern 


maxnames 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

Specifies  the  string  associated  with  the  font  names  you  want  returned.  You 
can  specify  any  string,  including  asterisks  (*),  and  question  marks.  The  aster¬ 
isk  indicates  a  wildcard  for  any  number  of  characters  and  the  question  mark 
indicates  a  wildcard  for  a  single  character.  Upper  or  lower  case  is  not  impor¬ 
tant.  The  string  should  be  in  ISO  LATIN- 1  encoding,  which  means  that  the 
first  128  character  codes  are  ASCII,  and  the  second  128  character  codes  are 
for  special  characters  needed  in  western  languages  other  than  English. 

Specifies  the  maximum  number  of  names  that  are  to  be  in  the  returned  list. 


actual_count 

Returns  the  actual  number  of  font  names  in  the  list. 


Description 

XListFonts  returns  a  list  of  font  names  that  match  the  string  pattern.  Each  returned  font 
name  string  is  terminated  by  null  and  is  lower  case.  The  maximum  number  of  names  returned 
in  the  list  is  the  value  you  passed  to  maxnames.  The  function  returns  the  actual  number  of 
font  names  in  actual_count. 

If  no  fonts  match  the  specified  names,  XListFonts  returns  null. 

The  client  should  call  XFreeFontNames  when  done  with  the  font  name  list. 


The  font  search  path  (the  order  in  which  font  names  in  various  directories  are  compared  to 
pattern)  is  set  by  XSetFontPath. 

For  more  information  on  fonts,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 


Related  Commands 

XCreateFontCursor, XFreeFont, XFreeFont Inf o,  XFreeFontNames,  XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFontsWithlnf o, XLoad- 
Font,  XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath,  XUnloadFont. 
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—  Xlib  -  Fonts 


XListFontsWithlnfo 


/ 


Name 

XListFontsWithlnfo  —  obtain  the  names  and  information  about  loaded  fonts. 

Synopsis 

char  **XListFontsWithInfo (display,  pattern ,  maxnames, 
count,  info) 


Display  ^display ; 

char  * pattern ; 

/* 

null-terminated  */ 

int  maxnames ; 

int  *  count; 

/* 

RETURN  */ 

XFontStruct  **info; 

/* 

RETURN  */ 

Arguments 

di  spl  ay 

pattern 


maxnames 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 

Specifies  the  string  associated  with  the  font  names  you  want  returned.  You 
can  specify  any  string,  including  asterisks  (*)  and  question  marks.  The  aster¬ 
isk  indicates  a  wildcard  on  any  number  of  characters  and  the  question  mark 
indicates  a  wildcard  on  a  single  character.  Upper  or  lower  case  is  not  impor¬ 
tant.  The  string  should  be  in  ISO  LATIN- 1  encoding,  which  means  that  the 
first  128  character  codes  are  ASCII,  and  the  second  128  character  codes  are 
for  special  characters  needed  in  western  languages  other  than  English. 

Specifies  the  maximum  number  of  names  that  are  to  be  in  the  returned  list. 


count  Returns  the  actual  number  of  matched  font  names. 


info  Returns  a  pointer  to  a  list  of  font  information  structures.  XListFonts¬ 

Withlnfo  provides  enough  space  for  maxnames  pointers. 

Description 

XListFontsWithlnfo  returns  a  list  of  font  names  that  match  the  specified  pattern  and  a 
also  returns  limited  information  about  each  font  that  matches.  The  list  of  names  is  limited  to 
the  size  specified  by  the  maxnames  argument  The  list  of  names  is  in  lower  case. 


XListFontsWithlnfo  returns  NULL  if  no  matches  were  found. 


To  free  the  allocated  name  array,  the  client  should  call  XFreeFont Names.  To  free  the  font 
information  array,  the  client  should  call  XFreeFont  Info. 

The  information  returned  for  each  font  is  identical  to  what  XQueryFont  would  return,  except 
that  the  per-character  metrics  (lbearing,  rbearing,  width,  ascent,  descent  for 
single  characters)  are  not  returned. 

The  font  search  path  (the  order  in  which  font  names  in  various  directories  are  compared  to 
pattern)  is  set  by  XSetFontPath.  XListFonts  returns  NULL  if  no  matches  were  found. 

For  more  information  on  fonts,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 
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XListFontsWithlnfo 


(continued) 


Xlib  -  Fonts 


Structures 

typedef  struct  { 

XExtData  *ext_data;  /* 

Font  fid;  /* 

unsigned  direction;  /* 

unsigned  min_char_or_byte2;  /* 
unsigned  max_char_or_byte2;  /* 
unsigned  min_bytel;  /* 

unsigned  max_bytel;  /* 

Bool  all_chars_exist;  /* 

unsigned  def ault_char;  /* 

int  n_properties;  /* 

XFontProp  *properties;  /* 

XCharStruct  min_bounds;  /* 

XCharStruct  max_bounds;  /* 

XCharStruct  *per_char;  /* 

int  ascent;  /* 

int  descent;  /* 

}  XFont Struct; 


hook  for  extension  to  hang  data  */ 

Font  ID  for  this  font  */ 

hint  about  direction  the  font  is  painted  */ 

first  character  */ 

last  character  */ 

first  row  that  exists  */ 

last  row  that  exists  */ 

flag  if  all  characters  have  nonzero  size*/ 
char  to  print  for  undefined  character  */ 
how  many  properties  there  are  */ 
pointer  to  array  of  additional  properties*/ 
minimum  bounds  over  all  existing  char*/ 
minimum  bounds  over  all  existing  char*/ 
first_char  to  last_char  information  */ 
logical  extent  above  baseline  for  spacing  */ 
logical  descent  below  baseline  for  spacing  */ 


Related  Commands 

XCreateFontCursor, XFreeFont, XFreeFont Inf o, XFreeFontNames,  XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts,  XLoadFont, 
XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath,  XUnloadFont. 
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—  Xlib  -  Host  Access 


XListHosts 


/ 


Name 

XListHosts  —  obtain  a  list  of  hosts  having  access  to  this  display. 

Synopsis 

XHostAddress  *XListHosts ( display,  nhosts,  state) 
Display  * display ; 

int  *  nhosts;  /*  RETURN  */ 

Bool  *  state;  /*  RETURN  */ 

Arguments 

displ ay 

nhosts 
state 


Description 

XListHosts  returns  the  current  access  control  list  as  well  as  whether  the  use  of  the  list  is 
enabled  or  disabled.  XListHosts  allows  a  program  to  find  out  what  machines  make  connec¬ 
tions,  by  looking  at  a  list  of  host  structures.  This  XHostAddress  list  should  be  freed  when  it 
is  no  longer  needed.  XListHosts  returns  null  on  failure. 

For  more  information  on  access  control  lists,  see  Volume  One,  Chapter  13,  Other  Programming 
Techniques. 

Structures 

typedef  struct  { 
int  family; 
int  length; 
char  *address; 

}  XHostAddress; 

Related  Commands 

XAddHost, XAddHosts, XDisableAccessControl,  XEnableAccessControl, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 


Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
Returns  the  number  of  hosts  currently  in  the  access  control  list. 

Returns  whether  the  access  control  list  is  currently  being  used  by  the  server  to 
process  new  connection  requests  from  clients.  True  if  enabled,  False  if 
disabled. 
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XListlnstalledColormaps  \_ 


Xlib  -  Colormaps— 


Name 

XListlnstalledColormaps  —  get  a  list  of  installed  colormaps. 

Synopsis 

Colormap  *XListInstalledColormaps  ( display,  w,  num) 
display  ^display ; 

Window  w ; 

int  *num;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 

w  Specifies  the  ID  of  the  window  for  whose  screen  you  want  the  list  of  currently 

installed  colormaps. 

num  Returns  the  number  of  currently  installed  colormaps  in  the  returned  list. 

Description 

XListlnstalledColormaps  returns  a  list  of  the  currently  installed  colormaps  for  the 
screen  containing  the  specified  window.  The  order  in  the  list  is  not  significant.  There  is  no  dis¬ 
tinction  in  the  list  between  colormaps  actually  being  used  by  windows  and  colormaps  no  longer 
in  use  which  have  not  yet  been  freed  or  destroyed. 

XListlnstalledColormaps  returns  None  and  sets  num  to  zero  on  failure. 

The  allocated  list  should  be  freed  using  XFree  when  it  is  no  longer  needed. 

For  more  information  on  installing  colormaps,  see  Volume  One,  Chapter  7,  Color. 

Errors 

BadWindow 

Related  Commands 

Def aultColormap, DisplayCells, XCopyColormapAndFree,  XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XInstallColormap, 
XSetStandardColormap, XSetWindowColormap,  XUninstallColormap. 
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—  Xlib  -  Window  Manager  Hints 


XListPixmapFormats 


/ 


Name 

XListPixmapFormats  —  obtain  the  supported  pixmap  formats  for  a  given  server. 

Synopsis 

XPixmapFormatValues  ^XListPixmapFormats (  display ,  count) 
Display  ^display ; 
int  *  count ;  /*  RETURN  */ 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

count  Returns  the  number  of  pixmap  formats  that  are  supported  by  the  server. 

Availability 

Release  4  and  later. 

Description 

XListPixmapFormats  returns  an  array  of  XPixmapFormatValues  structures  that 
describe  the  types  of  Z  format  images  that  are  supported  by  the  specified  server.  If  insufficient 
memory  is  available,  XListPixmapFormats  returns  NULL.  To  free  the  allocated  storage  for 
the  XPixmapFormatValues  structures,  use  XFree. 

Structures 

typedef  struct  { 
int  depth; 
int  bits_per_pixel; 
int  scanline_pad; 

}  XPixmapFormatValues; 

Related  Commands 

XListDepths. 
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XListProperties 


Xlib  -  Properties— 


\ 


Name 

XListProperties  —  get  the  property  list  for  a  window. 

Synopsis 

Atom  *XListProperties (display,  w,  num_prop) 

Display  ^display ; 

Window  w; 

int  *num _prop;  /*  RETURN  */ 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xopenDisplay. 
w  Specifies  the  window  whose  property  list  you  want. 

num jprop  Returns  the  length  of  the  properties  array. 

Description 

XListProperties  returns  a  pointer  to  an  array  of  atoms  for  properties  that  are  defined  for 
the  specified  window.  XListProperties  returns  NULL  on  failure  (when  window  wis  inva¬ 
lid). 

To  free  the  memory  allocated  by  this  function,  use  XFree. 

For  more  information,  see  Volume  One,  Chapter  10,  Inter  client  Communication. 

Errors 

BadWindow 

Related  Commands 

XChangeProperty,  XDeleteProperty, XGetAtomName,  XGetFontProperty, 
XGetWindowProperty,  XInternAtom,  XRotateWindowProperties, XSet- 
StandardProperties. 
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XLoadFont 


—  Xlib  -  Fonts - - ' 

Name 

XLoadFont  —  load  a  font  if  not  already  loaded;  get  font  ID. 

Synopsis 

Font  XLoadFont (display,  name) 

Display  *display ; 
char  *name ; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDi splay. 

name  Specifies  the  name  of  the  font  in  a  null  terminated  string.  As  of  Release  4,  the 

*  and  ?  wildcards  are  allowed  and  may  be  supported  by  the  server.  Upper  or 
lower  case  is  not  important.  The  string  should  be  in  ISO  LATIN- 1  encoding, 
which  means  that  the  first  128  character  codes  are  ASCII,  and  the  second  128 
character  codes  are  for  special  characters  needed  in  western  languages  other 
than  English. 

Description 

XLoadFont  loads  a  font  into  the  server  if  it  has  not  already  been  loaded  by  another  client. 
XLoadFont  returns  the  font  ID  or,  if  it  was  unsuccessful,  generates  a  BadName  error.  When 
the  font  is  no  longer  needed,  the  client  should  call  xunloadFont.  Fonts  are  not  associated 
with  a  particular  screen.  Once  the  font  ID  is  available,  it  can  be  set  in  the  font  member  of  any 
GC,  and  thereby  used  in  subsequent  drawing  requests. 

Font  information  is  usually  necessary  for  locating  the  text.  Call  XLoadFontwithlnf o  to 
get  the  info  at  the  time  you  load  the  font,  or  call  XQueryFont  if  you  used  XLoadFont  to 
load  the  font. 

For  more  information  on  fonts,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 

Errors 

BadAlloc  Server  has  insufficient  memory  to  store  font. 

BadName  name  specifies  an  unavailable  font. 

Related  Commands 

XCreateFontCursor,  XFreeFont,  XFreeFontlnf  o,  XFreeFontNames,  XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts,  XListFontsWith- 
Inf o,  XLoadQueryFont, XQueryFont, XSetFont,  XSetFontPath,  XUnloadFont. 
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XLoadQueryFont 


Xllb- Fonts— 


\ 


Name 

XLoadQueryFont  —  load  a  font  and  fill  information  structure. 

Synopsis 

XFontStruct  *XLoadQueryFont (  display,  name ) 
Display  * display ; 
char  *name ; 


Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  xOpenDi splay. 

name  Specifies  the  name  of  the  font.  This  name  is  a  null  terminated  string.  As  of 

Release  4,  the  *  and  ?  wildcards  are  allowed  and  may  be  supported  by  the 
server.  Upper  or  lower  case  is  not  important. 

Description 

XLoadQueryFont  performs  an  XLoadFont  and  XQueryFont  in  a  single  operation.  XLoad¬ 
QueryFont  provides  the  easiest  way  to  get  character-size  tables  for  placing  a  proportional  font. 
That  is,  XLoadQueryFont  both  opens  (loads)  the  specified  font  and  returns  a  pointer  to  the 
appropriate  XFontStruct  structure.  If  the  font  does  not  exist,  XLoadQueryFont  returns  NULL. 

The  XFontStruct  structure  consists  of  the  font-specific  information  and  a  pointer  to  an  array 
of  xcharStruct  structures  for  each  character  in  the  font. 

For  more  information  on  fonts,  see  Volume  One,  Chapter  6,  Drawing  Graphics  and  Text. 


Errors 

BadAlloc  server  has  insufficient  memory  to  store  font 
BadName  name  specifies  an  unavailable  font 


Structures 


typedef  struct  { 

XExtData  *ext_data; 

Font  fid; 

unsigned  direction; 
unsigned  min_char_or_byte2; 
unsigned  max_char_or_byte2; 
unsigned  min_bytel; 
unsigned  max_bytel; 

Bool  all_chars_exist; 
unsigned  def ault_char; 
int  n_properties; 

XFontProp  *properties; 
XCharStruct  min_bounds; 
XCharStruct  max_bounds; 
XcharStruct  *per_char; 
int  ascent; 
int  descent; 

}  XFontStruct; 


/*  hook  for  extension  to  hang  data  */ 

/*  Font  ID  for  this  font  */ 

/*  hint  about  direction  the  font  is  painted  */ 

/*  first  character  */ 

/*  last  character  */ 

/*  first  row  that  exists  */ 

/*  last  row  that  exists  */ 

/*  flag  if  all  characters  have  nonzero  size*/ 

/*  char  to  print  for  undefined  character  */ 

/*  how  many  properties  there  are  */ 

/*  pointer  to  array  of  additional  properties*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  minimum  bounds  over  all  existing  char*/ 

/*  first_char  to  last_char  information  */ 

/*  logical  extent  above  baseline  for  spacing  */ 
/*  logical  descent  below  baseline  for  spacing  */ 
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Xlib- Fonts  (continued)  XLoadQueryFont 

typedef  struct  { 

short  lbearing; 
short  rbearing; 
short  width; 
short  ascent; 
short  descent; 
unsigned  short  attributes; 

}  XCharStruct; 

Related  Commands 

XCreateFontCursor, XFreeFont, XFreeFont Inf o,  XFreeFontNames, XFree- 

FontPath, XGetFontPath, XGetFontProperty, XListFonts,  XListFontsWith- 

Info,  XLoadFont, XQueryFont, XSetFont,  XSetFontPath, XUnloadFont. 


/*  origin  to  left  edge  of  character  */ 

/*  origin  to  right  edge  of  character  */ 

/*  advance  to  next  char's  origin  */ 

/*  baseline  to  top  edge  of  character  */ 

/*  baseline  to  bottom  edge  of  character  */ 
/*  per  char  flags  (not  predefined)  */ 
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XLookUpAssoc 


Xlib  -  Association  Tables 


\ 


Name 

XLookUpAssoc  —  obtain  data  from  an  association  table. 

Synopsis 

caddr_t  XLookUpAssoc ( display,  table,  x_id) 

Display  * display ; 

XAssocTable  *  table; 

XID  x_id; 

Arguments 

display  Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
table  Specifies  the  association  table. 

x_id  Specifies  the  X  resource  ID. 

Description 

This  function  is  provided  for  compatibility  with  X  Version  10.  To  use  it  you  must  include  the 
file  <XlllX10.h>  and  link  with  the  library  -loldX. 

Association  tables  provide  a  way  of  storing  data  locally  and  accessing  by  ID.  XLookUp¬ 
Assoc  retrieves  the  data  stored  in  an  XAssocTable  by  its  XID.  If  the  matching  xid  can  be 
found  in  the  table,  the  routine  returns  the  data  associated  with  it.  If  the  x_id  cannot  be  found 
in  the  table  the  routine  returns  NULL. 

For  more  information  on  association  tables,  see  Volume  One,  Appendix  B,X10  Compatibility . 

Structures 

typedef  struct  { 

XAssoc  *buckets; 
int  size; 

}  XAssocTable; 

typedef  struct  _XAssoc  { 

struct  _XAssoc  *next;  /* 

struct  _XAssoc  *prev;  /* 

Display  *display;  /* 

XID  x_id;  /* 

char  *data;  /* 

}  XAssoc; 


next  object  in  this  bucket  */ 
previous  object  in  this  bucket  */ 
display  which  owns  the  ID  */ 

X  Window  System  ID  */ 
pointer  to  untyped  memory  */ 


/*  pointer  to  first  bucket  in  bucket  array  */ 
/*  table  size  (number  of  buckets)  */ 


Related  Commands 

XCreateAssocTable, XDeleteAssoc,  XDestroyAssocTable, XMakeAssoc. 
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XLookupColor 


/ 


Name 

XLookupColor  —  get  database  RGB  values  and  closest  hardware-supported  RGB  values  from 
color  name. 


Synopsis 

Status  XLookupColor {display,  cmap,  colorname,  rgb_db_def, 
hardware_def ) 

Display  ^display ; 

Colo rmap  cmap ; 
char  * colorname ; 

XColor  *rgb_db_def,  *hardware_def ;  /*  RETURN  */ 


Arguments 

display 

cmap 

colorname 


rgb_db_def 
hardware_def 

Description 

XLookupColor  looks  up  RGB  values  for  a  color  given  the  colorname  string.  It  returns  both 
the  exact  color  values  and  the  closest  values  possible  on  tthe  screen  specified  by  cmap. 

XLookupColor  returns  nonzero  if  colorname  exists  in  the  RGB  database  or  zero  if  it  does 
not  exist. 

To  determine  the  exact  RGB  values,  XLookupColor  uses  a  database  on  the  X  server.  On 
UNIX,  this  database  is  /usr/lib/Xll/rgb.  To  read  the  colors  provided  by  the  database  on  a 
UNIX-based  system,  see  lusrlliblXlllrgb.txt.  The  location,  name,  and  contents  of  this  file  are 
server-dependent. 

For  more  information  see  Volume  One,  Chapter  7,  Color ,  and  Appendix  D,  The  Color  Data¬ 
base,  in  this  volume. 


Specifies  a  connection  to  an  X  server;  returned  from  XOpenDisplay. 
Specifies  the  colormap. 

Specifies  a  color  name  string  (for  example  “red”).  Upper  or  lower  case 
does  not  matter.  The  string  should  be  in  ISO  LATIN  1  encoding,  which 
means  that  the  first  128  character  codes  are  ASCII,  and  the  second  128 
character  codes  are  for  special  characters  needed  in  western  languages 
other  than  English. 

Returns  the  exact  RGB  values  for  the  specified  color  name  from  the 
/usr/lib/Xlllrgb  database. 

Returns  the  closest  RGB  values  possible  on  the  hardware. 
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XLookupColor 


(continued) 


Xlib  -  Color  Cells 


Errors 

BadName  Color  name  not  in  database. 

BadColormap  Specified  colormap  invalid. 

Structures 

typedef  struct  { 

unsigned  long  pixel; 

unsigned  short  red,  green,  blue; 

char  flags;  /*  DoRed,  DoGreen,  DoBlue  */ 

char  pad; 

}  XColor ; 

Related  Commands 

BlackPixel, WhitePixel, XAllocColor,  XAllocColorCells, XAllocColor- 
Planes,  XAllocNamedColor,  XFreeColors,  XParseColor,  XQueryColor, 
XQueryColors, XStoreColor, XStoreColors,  XStoreNamedColor. 
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XLookupKeysym 


/ 


Name 

XLookupKeysym  —  get  the  keysym  corresponding  to  a  keycode  in  structure. 

Synopsis 

KeySym  XLookupKeysym ( event,  Index) 

XKeyEvent  *  event; 
int  index; 

Arguments 

event  Specifies  the  KeyPress  or  KeyRelease  event  that  is  to  be  used. 

index  Specifies  which  keysym  from  the  list  associated  with  the  keycode  in  the  event  to 
return.  These  correspond  to  the  modifier  keys,  and  the  symbols  ShiftMap- 
Index,  LockMapIndex,  ControlMapIndex,  ModlMapIndex,  Mod2- 
Maplndex,  Mod3MapIndex,  Mod4MapIndex,  and  Mod5MapIndex  can  be 
used. 

Description 

Given  a  keyboard  event  and  the  index  into  the  list  of  keysyms  for  that  keycode,  XLookup¬ 
Keysym  returns  the  keysym  from  the  list  that  corresponds  to  the  keycode  in  the  event.  If  no 
keysym  is  defined  for  the  keycode  of  the  event,  XLookupKeysym  returns  NoSymbol. 

Each  keycode  may  have  a  list  of  associated  keysyms,  which  are  portable  symbols  representing 
the  meanings  of  the  key.  The  index  specifies  which  keysym  in  the  list  is  desired,  indicating 
the  combination  of  modifier  keys  that  are  currently  pressed.  Therefore,  the  program  must  inter¬ 
pret  the  state  member  of  the  XKeyEvent  structure  to  determine  the  index  before  calling 
this  function.  The  exact  mapping  of  modifier  keys  into  the  list  of  keysyms  for  each  keycode  is 
server-dependent  beyond  the  fact  that  the  first  keysym  corresponds  to  the  keycode  without 
modifier  keys,  and  the  second  corresponds  to  the  keycode  with  Shift  pressed. 

XLookupKeysym  simply  calls  XKeycodeToKeysym,  using  arguments  taken  from  the  speci¬ 
fied  event  structure. 


Structures 


typedef  struct  { 
int  type; 

unsigned  long  serial; 
Bool  send_event;  / 
Display  *display; 
Window  window; 

Window  root; 

Window  subwindow; 

Time  time; 
int  x,  y; 

int  x_root ,  y_root ; 
unsigned  int  state; 
unsigned  int  keycode; 
Bool  same_screen; 

}  XKeyEvent; 


/*  of  event  */ 

/*  #  of  last  request  processed  by  server  */ 

*  true  if  this  came  from  a  SendEvent  request  */ 
/*  display  the  event  was  read  from  */ 

/*  "event"  window  it  is  reported  relative  to  */ 
/*  root  window  that  the  event  occured  on  */ 

/*  child  window  */ 

/*  milliseconds  */ 

/*  pointer  x,  y  coordinates  in  event  window  */ 
/*  coordinates  relative  to  root  */ 

/*  key  or  button  mask  */ 

/*  detail  */ 

/*  same  screen  flag  */ 
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XLookupKeysym 


(continued) 


Xlib  -  Keyboard 


Related  Commands 

XChangeKeyboardMapping,  XDeleteModif  iermapEntry,  XFreeModif  iermap, 
XGetKeyboardMapping,  XGetModif  ierMapping,  XInsertModif  iermapEntry, 
XKeycodeToKeysym,  XKeysymToKeycode,  XKeysymToString,  XLookupString, 
XNewModif  ierMap,  XQueryKeymap,  XRebindKeysym,  XRef  reshKeyboard- 
Mapping,  XSetModif ierMapping,  XStringToKeysym. 
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—  Xlib-  Keyboard 


XLookupString 


/ 


Name 

XLookupString  —  map  a  key  event  to  ASCII  string,  keysym,  and  ComposeStatus. 


Synopsis 

int  XLookupString ( event ,  buffer, 


XKeyEvent  *event; 

char  * buffer; 

/* 

int  num_bytes ; 

KeySym  * keysym; 

/* 

XComposeStatus  *  status; 

/* 

n um_by tes,  k eysym , 
RETURN  */ 

RETURN  */ 

not  implemented  */ 


status) 


Arguments 

event  Specifies  the  key  event  to  be  used. 

buffer  Returns  the  resulting  string. 

num_bytes  Specifies  the  length  of  the  buffer.  No  more  than  num_bytes  of  translation 
are  returned. 

keysym  If  this  argument  is  not  NULL,  it  specifies  the  keysym  ID  computed  from  the 

event. 

status  Specifies  the  XCompose  structure  that  contains  compose  key  state  informa¬ 

tion  and  that  allows  the  compose  key  processing  to  take  place.  This  can  be 
null  if  the  caller  is  not  interested  in  seeing  compose  key  sequences.  Not 
implemented  in  X  Consortium  Xlib  through  Release  4. 

Description 

XLookupString  gets  an  ASCII  string  and  a  keysym  that  are  currently  mapped  to  the  keycode 
in  a  KeyPress  or  KeyRe lease  event,  using  the  modifier  bits  in  the  key  event  to  deal  with 
shift,  lock  and  control.  The  XLookupString  return  value  is  the  length  of  the  translated 
string  and  the  string’s  bytes  are  copied  into  buffer.  The  length  may  be  greater  than  1  if  the 
event’s  keycode  translates  into  a  keysym  that  was  rebound  with  XRebindKeysym. 

The  compose  status  is  not  implemented  in  any  release  of  the  X  Consortium  version  of  Xlib 
through  Release  4. 

In  Release  4,  XLookupString  implements  the  new  concept  of  keyboard  groups.  Keyboard 
groups  support  having  two  complete  sets  of  keysym s  for  a  keyboard.  Which  set  will  be  used 
can  be  toggled  using  a  particular  key.  This  is  implemented  by  using  the  first  two  keysyms  in 
the  list  for  a  key  as  one  set,  and  the  next  two  keysyms  as  the  second  set.  For  more  information 
on  keyboard  groups,  see  Volume  One,  Appendix  G,  Release  Notes. 

For  more  information  on  using  XLookupString  in  general,  see  Volume  One,  Chapter  9,  The 
Keyboard  and  Pointer. 

Structures 

/* 

*  Compose  sequence  status  structure,  used  in  calling  XLookupString. 

*/ 
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